왜 지금 Rust 설치와 환경설정이 중요할까요
러스트(Rust)를 배우기로 결심하고 설레는 마음으로 터미널을 열었을 때, 갑자기 나타난 붉은색 에러 메시지를 마주하며 당혹스러웠던 적이 있나요? 분명 가이드를 따라 클릭했는데 “linker ‘cc’ not found”라거나 “Visual Studio C++ build tools is required” 같은 메시지가 뜨면 의욕이 꺾이기 마련이에요. 개발을 시작하기도 전에 환경 설정이라는 거대한 벽에 부딪히는 셈이죠.
많은 입문자가 단순히 설치 파일을 실행하면 모든 것이 끝날 거라고 생각해요. 하지만 러스트는 메모리 안전성과 성능을 동시에 잡기 위해 시스템 하위 레벨의 도구들과 긴밀하게 상호작용해요. 즉, 컴파일러가 제대로 작동할 수 있는 밑바탕이 갖춰지지 않으면, 코드를 한 줄도 제대로 실행할 수 없다는 뜻이에요.
오늘 이 글을 통해 우리는 단순히 설치 명령어를 복사해서 붙여넣는 것을 넘어, 여러분의 운영체제에 딱 맞는 최적의 개발 환경을 구축하는 방법을 배울 거예요. 환경 설정을 완벽하게 끝내 놓으면, 나중에 라이브러리를 추가하거나 복잡한 프로젝트를 진행할 때 발생할 수 있는 수많은 삽질을 미리 방지할 수 있어요.
- 운영체제별(Windows, macOS, Linux) 필수 사전 준비물
- rustup을 활용한 스마트한 도구 설치 프로세스
- Cargo와 VS Code를 결합한 최강의 개발 환경 세팅
- 설치 중 발생하는 흔한 오류와 즉각적인 해결법
설치 전 반드시 확인해야 할 사전 준비 사항
본격적으로 설치를 시작하기 전에, 여러분의 컴퓨터가 러스트를 받아들일 준비가 되었는지 확인해야 해요. rustup이라는 도구가 모든 것을 관리해주긴 하지만, 이 도구가 돌아가기 위한 기초 체력이 필요하거든요. 운영체제마다 요구하는 최소한의 도구가 다르기 때문에, 이를 무시하고 설치를 진행하면 결국 중간에 멈추게 돼요.
가장 먼저 결정해야 할 것은 여러분이 사용할 toolchain(도구 모음)의 종류예요. 보통은 가장 안정적인 stable 버전을 사용하지만, 최신 기능을 실험해보고 싶다면 nightly 버전을 고려할 수도 있어요. 하지만 입문자라면 고민하지 말고 안정적인 버전을 선택하는 것이 정신 건강에 이로워요.
아래 표를 통해 여러분의 운영체제에 따라 무엇을 미리 준비해야 하는지 한눈에 확인해보세요.
| 운영체제 | 필수 사전 도구 | 설치 난이도 | 주요 특징 |
|---|---|---|---|
| Windows | Visual Studio Build Tools | 중상 | C++ 컴파일러 환경 필수 |
| macOS | Xcode Command Line Tools | 하 | 터미널 명령 한 줄로 가능 |
| Linux | build-essential (gcc, make 등) | 중 | 패키지 매니저 활용 |
왜 이렇게 복잡한 과정을 거쳐야 할까요? 러스트는 소스 코드를 기계어로 바꾸는 과정에서 시스템의 표준 라이브러리를 사용하기 때문이에요. 특히 Windows 사용자의 경우, C++ 코드를 컴파일하는 도구가 없으면 러스트가 만든 결과물을 실행 파일로 묶어낼 수 없어요. 설치 전 이 과정을 건너뛰면 나중에 훨씬 더 복잡한 오류를 마주하게 되니, 반드시 표에 적힌 도구들을 먼저 갖춰놓으세요.
Windows 사용자라면 Visual Studio를 설치할 때 반드시 “C++를 사용한 데스크톱 개발” 워크로드를 체크해야 해요. 단순히 Visual Studio 프로그램만 설치해서는 러스트가 작동하지 않아요.
단계별 Rust 설치 및 개발 환경 구축 가이드
이제 모든 준비가 끝났다면 실제 설치를 진행할 차례예요. 이 과정은 단순히 프로그램을 까는 게 아니라, 여러분의 컴퓨터에 러스트라는 생태계를 심는 작업이라고 생각하면 돼요. 각 단계를 차근차근 따라오세요.
STEP 1. 운영체제별 빌드 환경 최종 점검
설치 명령어를 입력하기 전에, 아까 말한 사전 도구들이 제대로 있는지 한 번 더 확인해봐요. 이 단계가 흔들리면 이후의 모든 단계가 무너져요.
Windows 사용자는 제어판이나 Visual Studio Installer를 열어서 ‘C++를 사용한 데스크톱 개발’ 항목이 설치되어 있는지 꼭 확인하세요. 만약 없다면 설치 중에 에러가 발생하며 멈출 거예요.
macOS 사용자는 터미널을 열고 xcode-select --install 명령어를 입력해 보세요. 팝업창이 뜨면서 설치를 진행한다면 준비 완료예요.
Linux 사용자는 배포판에 맞는 패키지 매니저를 사용하세요. Ubuntu 계열이라면 sudo apt update && sudo apt install build-essential를 입력하면 필요한 도구들이 한 번에 설치돼요.
STEP 2. rustup을 이용한 핵심 도구 설치
러스트의 모든 버전 관리와 설치를 담당하는 마법 같은 도구가 바로 rustup이에요. 이걸 사용하면 나중에 러스트 버전을 바꾸거나 특정 기능을 추가하는 게 아주 쉬워져요.
먼저 공식 홈페이지에서 제공하는 설치 스크립트를 실행해야 해요. macOS와 Linux는 터미널에 주어진 명령어를 그대로 복사해서 붙여넣으면 되고, Windows는 rustup-init.exe 파일을 다운로드해서 실행하면 돼요. 설치 과정에서 몇 가지 선택지가 나올 텐데, 대부분의 경우 ‘1’번(default)을 선택하면 돼요. 그러면 가장 안정적인 버전이 자동으로 설정돼요.
설치가 완료되었다면 터미널을 완전히 껐다가 다시 켜주세요. 그리고 rustc --version을 입력했을 때 버전 숫자가 출력된다면 성공이에요!
STEP 3. Cargo 패키지 매니저 활용하기
러스트 개발의 꽃은 Cargo(카고)라고 불리는 빌드 시스템이자 패키지 매니저예요. 우리가 다른 언어에서 npm이나 pip을 사용하듯, 러스트에서는 Cargo가 모든 라이브러리(Crate라고 불러요)를 관리해줘요.
Cargo를 사용하면 프로젝트를 만들고, 빌드하고, 실행하는 모든 과정이 단순해져요. 예를 들어 새로운 프로젝트를 만들고 싶다면 cargo new my_project라고 입력하면 돼요. 그러면 자동으로 폴더 구조가 잡히고 기본적인 소스 코드까지 만들어준답니다. 정말 편리하죠?
STEP 4. VS Code와 rust-analyzer로 개발 환경 최적화
코드를 작성할 때 메모장 같은 기본 에디터를 쓸 수는 없겠죠? 가장 추천하는 조합은 Visual Studio Code(VS Code)와 rust-analyzer 확장 프로그램이에요. 이 조합은 거의 필수라고 봐도 무방해요.
VS Code를 설치한 뒤, 왼쪽 확장(Extensions) 아이콘을 누르고 ‘rust-analyzer’를 검색해서 설치하세요. 이걸 설치하면 실시간으로 코드의 오류를 잡아주고, 함수 정의로 바로 이동하거나 자동 완성을 해주는 등 마치 숙련된 코딩 파트너가 옆에 있는 듯한 경험을 할 수 있어요. 만약 이 확장 프로그램이 없다면, 러스트 특유의 엄격한 문법 때문에 에러를 찾느라 시간의 절반을 허비하게 될 거예요.
STEP 5. 첫 프로젝트 실행과 최종 테스트
이제 모든 세팅이 끝났으니 진짜로 작동하는지 테스트해봐야겠죠? 앞에서 만든 프로젝트 폴더로 이동해서 cargo run 명령어를 입력해 보세요. 컴파일이 진행되고 마지막에 “Hello, world!”가 출력된다면 여러분의 환경 설정은 완벽하게 끝난 거예요.
- 상황: Windows 사용자가 Visual Studio 없이 설치를 시도함
- 현상: rustup 설치는 성공했으나, cargo run 시 “linker ‘link.exe’ not found” 에러 발생
- 해결: Visual Studio Installer 실행 $\rightarrow$ C++ 데스크톱 개발 설치 $\rightarrow$ 터미널 재시작 $\rightarrow$ 성공!
자주 하는 실수와 해결법
설치 과정에서 누구나 한 번쯤은 겪을 수 있는 당황스러운 상황들을 모아봤어요. 에러 메시지가 떴다고 너무 겁먹지 마세요. 대부분은 아래 방법으로 해결할 수 있답니다.
❌ ‘cargo’ 명령어를 찾을 수 없다고 나와요
왜 발생하는가: 설치는 잘 되었지만, 러스트 도구들이 들어있는 경로가 운영체제의 ‘환경 변수(PATH)’에 등록되지 않았기 때문이에요.
✅ 해결법: 터미널을 완전히 종료했다가 다시 실행해 보세요. 그래도 안 된다면 환경 변수 설정에서 러스트의 bin 폴더를 직접 추가해야 해요.
❌ 컴파일 중에 ‘linker error’가 발생해요
왜 발생하는가: 앞서 강조했듯이 C++ 빌드 도구(Linker)가 설치되지 않았거나, 설치 과정에서 누락되었을 때 발생해요.
✅ 해결법: Windows라면 Visual Studio의 C++ 데스크톱 개발 패키지를 다시 확인하고, macOS라면 Xcode Command Line Tools를 재설치하세요.
❌ 라이브러리(Crate)를 다운로드할 수 없어요
왜 발생하는가: 네트워크 연결 문제이거나, 회사나 학교의 보안 프로토콜(Proxy)이 Cargo의 통신을 막고 있기 때문이에요.
✅ 해결법: 인터넷 연결을 확인하고, 프록시 환경이라면 ~/.cargo/config.toml 파일에 프록시 설정을 추가해야 해요.
❌ rustup 업데이트가 안 돼요
왜 발생하는가: 현재 실행 중인 프로세스가 러스트 도구를 사용 중이어서 파일을 교체하지 못하는 경우가 있어요.
✅ 해결법: 열려 있는 모든 VS Code와 터미널을 닫고, 다시 터미널을 열어 rustup update를 입력하세요.
자주 묻는 질문
Q. 러스트 설치할 때 stable이랑 nightly 중 뭘 골라야 하나요?
처음 시작하신다면 무조건 stable 버전을 추천해요. nightly는 최신 기능을 제공하지만, 매일 기능이 바뀌어서 예기치 못한 에러를 만날 수 있거든요. 안정적인 학습을 위해서는 stable이 가장 좋습니다.
Q. Mac M1/M2 칩을 쓰는데 설치 과정이 다른가요?
기본적인 과정은 동일하지만, 설치 시 아키텍처가 aarch64-apple-darwin으로 설정되는지 확인하는 것이 좋아요. 대부분 rustup이 알아서 처리해주지만, 혹시라도 인텔용(x86_64)이 설치되면 성능이 떨어질 수 있어요.
Q. VS Code 말고 다른 에디터는 어떤 게 있나요?
JetBrains에서 만든 RustRover라는 전문 IDE도 있어요. 설정이 매우 간편하고 강력하지만, 유료 모델이 있다는 점을 참고하세요. 입문자에게는 무료이면서 가벼운 VS Code 조합을 가장 추천해요.
Q. 설치 용량이 너무 큰데 줄일 수 있는 방법이 있나요?
러스트 도구 자체는 크지 않지만, C++ 빌드 도구(Windows의 경우)가 꽤 많은 용량을 차지해요. 꼭 필요한 패키지만 골라서 설치하는 것이 최선이에요.
완벽한 러스트 시작을 위한 요약
환경 설정은 개발 여정의 아주 작은 부분이지만, 이 기초가 튼튼해야 그 위에 멋진 프로그램을 쌓아 올릴 수 있어요. 오늘 배운 내용을 잊지 않도록 핵심만 다시 정리해 드릴게요.
- 운영체제별 필수 빌드 도구(C++ 도구 등)를 먼저 설치할 것
- rustup을 통해 안정적인(stable) 도구 모음을 설치할 것
- Cargo를 활용해 프로젝트 관리와 라이브러리 추가를 진행할 것
- VS Code와 rust-analyzer 조합으로 생산성을 극대화할 것
- 설치 후 반드시 ‘Hello World’ 프로젝트로 최종 확인을 할 것
이제 모든 준비가 끝났습니다. 환경 설정이라는 큰 산을 하나 넘으셨으니, 이제는 러스트의 진짜 매력인 소유권(Ownership)과 빌림(Borrowing)이라는 개념을 만날 차례예요. 처음에는 조금 까다롭게 느껴질 수 있지만, 익숙해지면 이보다 더 안전하고 강력한 언어는 없다는 걸 깨닫게 될 거예요.
오늘 바로 해야 할 일: 터미널을 열고 rustup 설치 명령어를 실행하세요.
이번 주 목표: Cargo로 간단한 계산기 프로그램을 만들어 보세요.
실행 직전 체크: VS Code에 rust-analyzer가 제대로 설치되어 있는지 확인하세요!
배포 전 Rust 설치와 환경설정 체크리스트를 통해 여러분의 개발 환경이 완벽한지 꼭 다시 한번 점검해 보세요. 러스트의 세계에 오신 것을 진심으로 환영합니다!
관련 글 안내: Rust 설치와 환경설정 관련 다른 글과 입문 Rust 학습 가이드를 통해 실력을 더 키워보세요.
