[IT-정보] Rust 설치와 환경설정 실수 해결하기 – 입문자를 위한 무결점 세팅 가이드

Rust 설치와 환경설정에서 왜 첫 단추부터 막힐까요

분명히 가이드를 보고 그대로 따라 했는데, 터미널에 rustc –version을 입력하자마자 ‘command not found’라는 차가운 메시지가 뜬 적이 있나요? 이제 막 프로그래밍의 세계에 발을 들인 입문자에게 이런 상황은 의욕을 꺾는 아주 큰 벽처럼 느껴지기 마련이에요.

Rust는 성능과 안전성을 모두 잡은 아주 매력적인 언어이지만, 설치 과정이 다른 언어에 비해 조금 까다로운 편이에요. 단순히 실행 파일을 내려받는 것에서 끝나는 게 아니라, 운영체제에 맞는 컴파일러 도구 모음을 갖추고, 환경 변수를 올바르게 등록하며, 코드 편집기와의 연결까지 마쳐야 비로소 개발을 시작할 수 있거든요.

대부분의 실패는 환경 변수 설정 오류나 C++ 빌드 도구 누락에서 시작돼요. 이 글은 바로 그런 시행착오를 줄이기 위해 작성되었어요. 저도 처음 Rust를 배울 때 똑같은 오류 메시지를 보며 밤을 지새웠던 경험이 있기에, 여러분이 겪을 수 있는 고통을 누구보다 잘 이해하고 있어요.

이 글을 끝까지 읽고 나면 다음과 같은 문제를 완벽하게 해결할 수 있어요.

• 운영체제별 필수 빌드 도구 준비 방법
• rustup을 이용한 올바른 설치 경로 확인
• VS Code와 Rust 개발 환경의 완벽한 연동
• 설치 중 발생하는 흔한 오류 메시지 대응법

자, 그럼 이제 오류 없는 깨끗한 개발 환경을 만들기 위한 여정을 함께 시작해봐요!

설치 전 반드시 확인해야 할 준비 사항

무턱대고 설치 명령어를 입력하기 전에, 현재 사용 중인 컴퓨터가 Rust를 받아들일 준비가 되었는지 확인해야 해요. Rust는 단순히 코드만 짜는 도구가 아니라, 컴퓨터의 자원을 직접 다루는 강력한 도구이기 때문에 시스템의 기초 공사가 아주 중요해요.

가장 먼저 확인해야 할 것은 컴파일러 도구 모음이에요. Rust는 코드를 기계어로 바꾸기 위해 운영체제가 제공하는 기본 빌드 도구들을 빌려 쓰거든요. 만약 윈도우 사용자라면 Visual Studio의 특정 구성 요소가 필요하고, 맥 사용자라면 Xcode 명령줄 도구가 있어야 해요. 이 과정이 빠지면 설치는 성공해도 실제 코드를 실행할 때 반드시 에러가 발생해요.

운영체제마다 요구하는 환경이 다르기 때문에, 아래 표를 보고 본인의 환경에 맞는 준비물을 미리 체크해두는 것이 좋아요.

준비가 끝났다면 이제 본격적으로 설치 단계로 넘어가기 전에 한 가지만 더 기억해주세요. 인터넷 연결 상태는 안정적이어야 해요. 설치 과정에서 수많은 라이브러리와 컴파일러 구성 요소를 다운로드하기 때문에, 중간에 연결이 끊기면 설치 파일이 꼬여버릴 수 있거든요.

실패 없는 Rust 설치 및 환경설정 단계별 가이드

이제 본격적인 실행 단계예요. 단순히 명령어를 복사해서 붙여넣는 것을 넘어, 각 단계가 어떤 의미를 갖는지 이해하면서 진행하면 나중에 발생할 문제를 스스로 해결할 수 있는 힘이 생겨요.

STEP 1. 운영체제별 기초 빌드 도구 설치하기

Rust 설치 전 가장 중요한 단계예요. 많은 입문자가 여기서 실수해서 시간을 허비하곤 하죠. 본인의 운영체제에 맞춰 아래 작업을 먼저 완료해주세요.

Windows 사용자라면, Microsoft 사이트에서 Visual Studio 설치 프로그램을 내려받아야 해요. 설치 시 반드시 ‘C++를 사용한 데스크톱 개발’ 워크로드를 체크해야 한다는 점을 잊지 마세요. 이 항목이 빠지면 Rust 코드를 빌드할 때 링크 에러가 발생하며 작동하지 않아요.

macOS 사용자라면, 터미널을 열고 xcode-select --install 명령어를 입력하세요. 별도의 창이 뜨면서 도구 설치를 도와줄 거예요. 설치가 완료될 때까지 잠시 기다려주세요.

Linux 사용자라면, 배포판의 패키지 관리자를 사용하세요. Ubuntu나 Debian 계열이라면 sudo apt update && sudo apt install build-essential 명령어를 통해 기본적인 컴파일러 환경을 구축할 수 있어요.

STEP 2. rustup을 활용한 Rust 설치 진행

기초 공사가 끝났다면 이제 진짜 Rust를 설치할 차례예요. 가장 권장되는 방식은 공식 도구인 rustup을 이용하는 것이에요. 이 도구는 Rust의 다양한 버전을 관리하고 업데이트하는 핵심 역할을 해요.

공식 웹사이트(rustup.rs)에서 제공하는 명령어를 터미널에 입력하세요. 윈도우는 실행 파일을 내려받아 실행하면 되고, 맥이나 리눅스는 아래와 같은 명령어를 사용해요.

설치가 진행되는 동안에는 잠시 기다려주세요. 네트워크 환경에 따라 몇 분 정도 소요될 수 있어요. 설치가 완료되면 터미널을 껐다가 다시 켜는 것이 가장 안전해요. 그래야 새로 설정된 환경 변수가 시스템에 완전히 반영되기 때문이에요.

STEP 3. 설치 성공 여부 및 환경 변수 검증

설치가 끝났다고 바로 코딩을 시작하면 안 돼요! 제대로 설치되었는지, 그리고 명령어를 입력했을 때 컴퓨터가 알아듣는지 확인하는 과정이 꼭 필요해요. 이 단계가 바로 환경 변수 검증 단계예요.

터미널을 새로 열고 다음 명령어를 입력해보세요.

rustc --version

만약 rustc 1.xx.x (hash date)와 같은 버전 정보가 출력된다면 성공이에요! 하지만 여전히 ‘command not found’가 뜬다면, Rust의 실행 파일 경로가 시스템의 PATH 환경 변수에 등록되지 않은 거예요. 이럴 때는 source $HOME/.cargo/env 명령어를 입력하거나, 수동으로 환경 변수를 편집해야 해요.

STEP 4. VS Code와 rust-analyzer 연동하기

이제 텍스트 편집기를 준비해야 해요. 전 세계 개발자들이 가장 많이 사용하는 Visual Studio Code(VS Code)를 기준으로 설명해 드릴게요. 단순히 코드만 적는 게 아니라, 실시간으로 문법 오류를 잡아주고 자동 완성을 도와주는 똑똑한 비서를 고용하는 과정이에요.

먼저 VS Code를 실행한 뒤, 왼쪽 사이드바의 확장(Extensions) 아이콘을 클릭하세요. 검색창에 rust-analyzer를 검색하고 설치 버튼을 누르세요. 주의할 점은, 과거에 사용되던 ‘Rust’라는 이름의 확장은 이제 더 이상 권장되지 않는다는 거예요. 반드시 rust-analyzer를 선택해야 훨씬 빠르고 정확한 기능을 누릴 수 있어요.

설치가 완료되면 VS Code 하단 상태 표시줄에 Rust 관련 정보가 뜨는 것을 볼 수 있어요. 이제 코드의 오타를 실시간으로 잡아주는 강력한 도구가 준비된 셈이에요.

STEP 5. Cargo를 이용한 첫 번째 프로젝트 실행

모든 준비가 끝났으니 마지막으로 실전 테스트를 해볼까요? Rust에서는 프로젝트 관리와 빌드를 Cargo라는 도구가 전담해요. Cargo를 사용하면 라이브러리를 추가하거나 프로그램을 실행하는 일이 매우 간단해져요.

터미널에서 원하는 작업 폴더로 이동한 뒤, 아래 명령어를 순서대로 입력해보세요.

1. cargo new hello_rust: 새로운 프로젝트 폴더를 생성해요.
2. cd hello_rust: 생성된 프로젝트 폴더 안으로 들어가요.
3. cargo run: 프로젝트를 컴파일하고 바로 실행해요.

화면에 ‘Hello, world!’라는 문구가 출력된다면, 여러분은 이제 완벽한 Rust 개발 환경을 갖춘 거예요! 축하해요, 드디어 첫 발을 내디뎠어요.

자주 하는 실수와 해결법

설치 과정에서 발생하는 문제는 대부분 정해져 있어요. 당황하지 말고 아래 리스트를 확인하며 하나씩 맞춰가보세요.

• ❌ 실수: rustc 명령어가 인식되지 않아요.
  왜 발생하는가: 설치 후 터미널을 재시작하지 않았거나, PATH 환경 변수에 Rust 경로가 추가되지 않았기 때문이에요.
  ✅ 해결법: 터미널을 완전히 종료한 뒤 다시 실행하거나, 사용 중인 운영체제의 환경 변수 설정에서 ~/.cargo/bin 경로를 추가해주세요.
• ❌ 실수: 링크 에러(Linker error)가 발생하며 빌드가 안 돼요.
  왜 발생하는가: C++ 빌드 도구(MSVC 등)가 설치되지 않았기 때문이에요.
  ✅ 해결법: 윈도우라면 Visual Studio Installer를 열어 ‘C++를 사용한 데스크톱 개발’ 항목을 반드시 체크하고 설치를 완료해주세요.
• ❌ 실수: 업데이트를 했는데 버전이 그대로예요.
  왜 발생하는가: rustup을 통한 업데이트가 아닌 다른 방식으로 설치했거나 명령어가 잘못되었을 수 있어요.
  ✅ 해결법: 터미널에 rustup update를 입력하여 공식 도구로 업데이트를 진행하세요.
• ❌ 실수: VS Code에서 코드 자동 완성이 안 돼요.
  왜 발생하는가: ‘Rust’ 확장을 설치했거나, ‘rust-analyzer’가 아직 프로젝트를 인덱싱 중일 수 있어요.
  ✅ 해결법: 기존 Rust 확장을 삭제하고 rust-analyzer를 다시 설치한 뒤 잠시 기다려주세요.
• ❌ 실수: 네트워크 오류로 패키지 다운로드가 끊겨요.
  왜 발생하는가: 사내 보안 망이나 프록시 서버가 Rust 저장소 접근을 차단하고 있을 확률이 높아요.
  ✅ 해결법: 프록시 설정을 환경 변수에 추가하거나, 안정적인 네트워크 환경에서 다시 시도하세요.

자주 묻는 질문

Q. Rust를 설치하면 용량을 많이 차지하나요?

컴파일러와 표준 라이브러리, 그리고 빌드 도구들을 모두 포함하면 생각보다 공간을 차지할 수 있어요. 보통 수 GB 정도의 여유 공간은 확보해두는 것이 안전해요.

Q. 윈도우에서 GNU 방식과 MSVC 방식 중 무엇을 써야 하나요?

입문자라면 윈도우 환경에서 가장 호환성이 좋은 MSVC 방식을 강력히 추천해요. 대부분의 라이브러리가 이 방식에 맞춰져 있기 때문이에요.

Q. 매번 설치할 때마다 명령어를 쳐야 하나요?

아니요, 한 번 설치하고 환경 변수 설정만 잘 되어 있다면, 이후에는 cargo 명령어만으로 모든 작업이 가능해요.

Q. Mac에서 M1/M2 칩을 쓰는데 괜찮을까요?

네, 당연하죠! Rust는 Apple Silicon을 완벽하게 지원해요. 설치 시 아키텍처를 자동으로 인식하니 걱정하지 마세요.

Q. 설치를 완전히 삭제하고 싶으면 어떻게 하나요?

터미널에 rustup self uninstall 명령어를 입력하면 깔끔하게 제거돼요.

완벽한 시작을 위한 마지막 체크리스트

환경 설정을 마쳤다면 이제 여러분 앞에는 무궁무진한 프로그래밍의 세계가 펼쳐져 있어요. 오늘 우리가 진행한 과정을 다시 한번 머릿속에 정리해볼까요?

이제 무엇을 해야 할지 막막하다면, 다음 단계를 따라 움직여보세요.

• 오늘 할 일: cargo new 명령어로 첫 프로젝트를 만들고 ‘Hello World!’를 화면에 띄워보세요.
• 이번 주 할 일: Rust 공식 문서인 ‘The Rust Programming Language’의 첫 장을 읽어보며 기초 문법을 익히세요.
• 실행 직전 할 일: 개발 중에 에러 메시지가 뜨면 당황하지 말고, 그 메시지를 그대로 복사해서 검색하는 습관을 들이세요.

Rust 설치와 환경설정 실수 없이 첫걸음을 뗀 여러분은 이미 절반은 성공한 것이나 다름없어요. 어려운 환경 설정의 고비를 넘겼으니, 이제는 Rust의 강력한 성능을 직접 경험하며 즐겁게 코딩하는 일만 남았답니다!

같은 실수를 반복하지 않도록 오늘 배운 내용을 꼭 메모해 두세요. 여러분의 멋진 Rust 개발 인생을 응원할게요!

관련하여 더 궁금한 점이 있다면 Rust 입문 학습 가이드나 Rust 설치와 환경설정 관련 다른 글들을 참고해 보세요.