Rust 설치와 환경설정, 왜 첫 단추가 중요할까요
새로운 프로그래밍 언어를 배우기로 마음먹고 설레는 마음으로 첫 코드를 작성하려 할 때, 예상치 못한 벽에 부딪히는 경험을 해본 적 있나요? 분명 강의에서는 잘만 되던 코드가 내 컴퓨터에서는 “명령어를 찾을 수 없습니다”라거나 “링커 오류가 발생했습니다”라는 붉은 글씨를 띄우며 멈춰버리는 상황 말이에요. 시스템 프로그래밍을 지향하는 Rust는 그 특성상 운영체제와 밀접하게 상호작용하기 때문에, 단순히 프로그램 하나를 까는 것 이상의 정교한 환경 구축이 필요해요.
특히 기존에 사용하던 다른 언어 환경이 이미 복잡하게 꼬여 있는 상태라면, 새로운 도구를 도입하는 과정에서 충돌이 일어나기도 해요. 이런 상황을 방치하면 나중에 프로젝트 규모가 커졌을 때 환경 문제 때문에 밤을 지새우는 불상사가 생길 수 있어요. 그래서 Rust 설치와 환경설정 단계는 단순히 설치 버튼을 누르는 과정이 아니라, 앞으로의 개발 여정을 결정짓는 기초 공사라고 생각해야 해요.
이 글을 끝까지 읽고 나면, 여러분은 더 이상 환경 설정 때문에 스트레스받지 않고 바로 코딩에 집중할 수 있는 상태가 될 거예요. 운영체제별 최적의 설치 경로를 이해하고, 혹시 모를 오류 상황에서도 침착하게 대처할 수 있는 능력을 갖추게 됩니다. 복잡한 설정 과정을 하나씩 짚어가며, 입문자가 가장 많이 실수하는 지점들을 꼼꼼하게 짚어드릴게요.
Rust는 메모리 안전성을 최우선으로 하는 언어인 만큼, 컴파일러와 도구 체인의 버전 관리가 매우 중요해요. 환경이 불안정하면 컴파일러가 내 의도와 다르게 동작할 수 있으니 주의하세요.
오늘 우리가 함께 해결할 과제는 다음과 같아요.
- 운영체제 환경에 맞는 최적의 설치 도구 선택하기
- Rust의 핵심 도구인 Rustup과 Cargo 완벽하게 이해하기
- 개발 생산성을 높여주는 IDE 환경 구축하기
- 설치 과정에서 발생하는 흔한 오류와 해결 방법 마스터하기
설치 전 필수 체크리스트와 운영체제별 준비 사항
무작정 설치를 시작하기 전에, 현재 여러분의 컴퓨터 상태를 점검하는 과정이 필요해요. 시스템 프로그래밍 언어는 운영체제의 라이브러리를 직접 호출하는 경우가 많아서, 기본적인 빌드 도구가 갖춰져 있지 않으면 설치가 완료되어도 정작 코드를 실행할 수 없는 상태가 되기 때문이에요.
가장 먼저 확인해야 할 것은 여러분이 사용할 운영체제의 종류와 권한이에요. 윈도우 사용자라면 Visual Studio의 빌드 도구가 설치되어 있는지 확인해야 하고, 맥이나 리눅스 사용자라면 터미널 명령어를 다룰 준비가 되어 있어야 해요. 또한, 기존에 설치된 다른 언어의 컴파일러와 경로(PATH)가 겹치지 않는지도 살펴보는 것이 좋아요.
운영체제별 요구 사항 비교
각 운영체제마다 Rust를 구동하기 위해 필요한 환경이 조금씩 달라요. 아래 표를 통해 본인의 환경에 무엇이 필요한지 미리 확인해 보세요.
| 운영체제 | 필수 구성 요소 | 추천 도구 | 주의 사항 |
|---|---|---|---|
| Windows | MSVC 빌드 도구 | Visual Studio 2019 이상 | C++ 워크로드 설치 필수 |
| macOS | Xcode Command Line Tools | Homebrew | Apple Silicon 대응 확인 |
| Linux | gcc 또는 clang | apt, pacman 등 패키지 매니저 | glibc 버전 호환성 체크 |
표에서 볼 수 있듯이, 윈도우 환경은 다른 운영체제에 비해 준비해야 할 과정이 조금 더 복잡해요. 특히 MSVC(Microsoft Visual C++) 라이브러리는 Rust 컴파일러가 코드를 기계어로 바꿀 때 꼭 필요한 짝꿍과 같아서, 이걸 빼먹으면 설치가 끝나더라도 제대로 된 동작을 기대하기 어려워요.
또한, Rust의 생태계를 이해하기 위해 꼭 알아야 할 세 가지 핵심 용어가 있어요. 이 용어들을 미리 익혀두면 나중에 설치 가이드를 읽을 때 훨씬 수월할 거예요.
- Rustup: Rust의 버전과 툴체인을 관리하는 설치 관리자예요. 마치 스마트폰의 앱스토어처럼 새로운 버전을 깔거나 이전 버전으로 돌리는 역할을 해요.
- Cargo: Rust의 강력한 패키지 매니저이자 빌드 도구예요. 라이브러리를 가져오고, 코드를 컴파일하고, 테스트를 실행하는 모든 과정을 담당해요.
- rustc: 실제 코드를 컴파일하는 핵심 엔진이에요. 하지만 우리는 보통 이 명령어를 직접 쓰기보다 Cargo를 통해 간접적으로 활용하게 돼요.
기존에 설치된 Python이나 Node.js 환경의 환경 변수가 꼬여 있다면, Rust 설치 과정에서 시스템 경로(PATH)가 엉뚱하게 잡힐 수 있어요. 설치 전 터미널에서
echo $PATH 명령어로 현재 경로를 미리 메모해두는 것을 추천해요.준비가 끝났다면, 이제 본격적으로 설치 단계로 넘어갈 차례예요. 운영체제별로 최적의 설치 방법이 다르니, 본인의 환경에 맞는 단계를 찾아 천천히 따라와 주세요.
Rust 설치와 환경설정 단계별 실전 가이드
이제 본격적인 실행 단계예요. 단순히 명령어를 입력하는 것을 넘어, 각 단계가 어떤 의미를 갖는지 이해하면서 진행하면 나중에 문제가 생겨도 스스로 해결할 수 있는 힘이 생겨요. 모든 과정은 가장 권장되는 표준 방식을 기준으로 설명할게요.
STEP 1. Rustup을 이용한 표준 설치 실행하기
Rust를 설치하는 가장 안전하고 확실한 방법은 공식 도구인 Rustup을 사용하는 거예요. Rustup은 단순히 설치만 해주는 게 아니라, 나중에 Rust 버전을 업데이트하거나 다른 타겟 플랫폼(예: 웹어셈블리)을 위한 컴파일러를 추가할 때도 사용되는 핵심 관리 도구예요.
윈도우(Windows) 사용자의 경우:
먼저 rustup-init.exe 파일을 공식 홈페이지에서 다운로드하세요. 실행하면 검은색 터미널 창이 나타날 거예요. 이때 가장 중요한 선택지가 나오는데, 대부분의 경우에는 1번(Default)을 선택하면 돼요. 하지만 만약 MSVC 빌드 도구가 설치되어 있지 않다면, 경고 메시지가 뜰 거예요. 당황하지 말고 안내에 따라 Visual Studio Installer를 실행해 ‘C++를 사용한 데스크톱 개발’ 워크로드를 설치한 뒤 다시 시도하세요.
맥(macOS) 및 리눅스(Linux) 사용자의 경우:
터미널을 열고 공식 사이트에서 제공하는 curl 명령어를 입력하세요. 명령어를 입력하면 스크립트가 다운로드되고 실행 권한을 물어볼 거예요. 명령어 실행 후에는 반드시 터미널을 완전히 껐다가 다시 켜야 해요. 그래야 새로 설정된 환경 변수가 시스템에 반영되기 때문이에요.
STEP 2. 환경 변수(PATH) 및 셸 설정 확인하기
설치가 끝났다고 해서 바로 명령어를 쓸 수 있는 건 아니에요. 컴퓨터가 “cargo가 어디 있지?”라고 물었을 때, 적절한 위치를 알려주는 환경 변수 설정이 완벽해야 해요. 보통 Rustup은 이 과정을 자동으로 해주지만, 가끔 수동으로 확인해야 할 때가 있어요.
터미널이나 명령 프롬프트(CMD)를 열고 rustc --version 명령어를 입력해 보세요. 만약 버전 정보가 깔끔하게 출력된다면 성공이에요. 만약 “명령어를 찾을 수 없습니다”라는 메시지가 나온다면, 설치 경로인 ~/.cargo/bin(리눅스/맥) 또는 C:\Users\사용자명\.cargo\bin(윈도우)이 시스템의 PATH에 등록되어 있는지 확인해야 해요.
리눅스나 맥 사용자라면
~/.bashrc나 ~/.zshrc 파일 끝에 Rust 관련 경로가 제대로 추가되어 있는지 확인하는 습관을 들이면 좋아요.STEP 3. 개발 생산성을 극대화하는 IDE 환경 구축하기
코드만 칠 수 있다고 개발이 되는 건 아니죠. Rust는 컴파일러가 매우 엄격하기 때문에, 코드를 치는 즉시 오류를 잡아주는 언어 서버(Language Server)가 필수적이에요. 가장 추천하는 조합은 VS Code(Visual Studio Code)와 rust-analyzer 확장 프로그램이에요.
VS Code를 설치했다면, 확장 마켓플레이스에서 ‘rust-analyzer’를 검색해 설치하세요. 주의할 점은 예전에 사용되던 ‘Rust’라는 이름의 확장 프로그램은 이제 업데이트가 중단되었으니, 반드시 rust-analyzer를 선택해야 한다는 점이에요. 이 도구가 설치되면 코드의 타입 정보, 자동 완성, 그리고 무엇보다 코드를 실행하기 전에 어디가 틀렸는지 실시간으로 보여주는 기능을 사용할 수 있어요.
STEP 4. 첫 번째 프로젝트 생성 및 실행 테스트
환경 설정이 완벽한지 확인하는 가장 좋은 방법은 직접 작은 프로그램을 돌려보는 거예요. 여기서 우리는 Rust의 빌드 시스템인 Cargo를 사용해 볼 거예요. 터미널에서 프로젝트를 만들고 싶은 폴더로 이동한 뒤, 다음 과정을 따라 해 보세요.
- 프로젝트 생성:
cargo new hello_rust명령어를 입력하세요. 이 명령어는 `hello_rust`라는 폴더를 만들고, 그 안에 필요한 기본 폴더 구조와 ‘Hello, world!’ 코드가 담긴 파일을 자동으로 생성해 줘요. - 폴더 이동:
cd hello_rust로 방금 만든 폴더 안으로 들어갑니다. - 실행하기:
cargo run을 입력하세요.
정상적으로 설치되었다면, 터미널에 “Hello, world!”라는 문구가 출력될 거예요. 이 과정에서 컴파일(Compile)과 실행(Run)이 한 번에 이루어지는 것을 확인할 수 있습니다. 이것이 바로 Cargo의 마법이에요.
STEP 5. 기존 환경과의 마이그레이션 및 확장 설정
만약 기존에 다른 언어로 된 프로젝트를 Rust로 전환하거나, 이미 사용 중인 환경에 Rust를 통합해야 한다면 조금 더 주의가 필요해요. 라이브러리 충돌을 피하기 위해, 새로운 프로젝트는 반드시 Cargo를 통해 격리된 환경에서 시작하는 것이 좋아요. 또한, 여러 버전의 Rust를 사용해야 하는 상황(예: 특정 프로젝트는 구버전 필요)이라면 rustup override set 명령어를 통해 프로젝트 폴더별로 다른 도구 체인을 지정할 수 있다는 점도 기억해 두세요.
[실전 예시 시나리오: 입문자의 하루]
1. 오전 10시: Rust 공식 홈페이지 방문 후 Rustup 설치 시작.
2. 오전 10시 30분: 윈도우 환경이라 MSVC 설치를 위해 Visual Studio 설치 병행.
3. 오전 11시 30분: 설치 완료 후 VS Code 설치 및 rust-analyzer 세팅 완료.
4. 오후 1시: `cargo run` 성공 확인 후 본격적인 학습 시작!
자주 하는 실수와 해결법 및 FAQ
설치 과정은 순탄할 수도 있지만, 예상치 못한 오류로 인해 막히는 경우가 많아요. 많은 입문자가 공통적으로 겪는 문제들을 모아 정리했으니, 비슷한 상황이 생기면 여기서 답을 찾아보세요.
자주 하는 실수와 해결법
❌ 실수: cargo 명령어를 쳤는데 “command not found”가 떠요.
왜 발생하는가: Rust 설치 후 환경 변수(PATH)가 현재 터미널 세션에 반영되지 않았기 때문이에요.
✅ 해결법: 터미널을 완전히 종료하고 다시 실행하거나, 명령어를 직접 실행하여 경로를 새로고침하세요.
❌ 실수: 윈도우에서 빌드할 때 “linker ‘link.exe’ not found” 오류가 발생해요.
왜 발생하는가: Rust 컴파일러가 코드를 기계어로 바꿀 때 사용할 MSVC 빌드 도구가 없기 때문이에요.
✅ 해결법: Visual Studio Installer를 실행해 ‘C++를 사용한 데스크톱 개발’ 구성 요소를 반드시 설치해야 해요.
❌ 실수: VS Code에서 코드 자동 완성이 전혀 안 돼요.
왜 발생하는가: ‘Rust’ 확장 프로그램이 설치되어 있거나, ‘rust-analyzer’가 제대로 동작하지 않는 상태예요.
✅ 해결법: 기존 Rust 확장을 삭제하고 반드시 ‘rust-analyzer’를 설치한 뒤, 오른쪽 하단에 분석 중이라는 표시가 사라질 때까지 기다려 보세요.
❌ 실수: 프로젝트를 만들었는데 라이브러리(Crate)를 불러올 수 없다고 나와요.
왜 발생하는가: 인터넷 연결 문제이거나, Cargo.toml 파일에 의존성 설정이 잘못되었을 수 있어요.
✅ 해결법: 인터넷 연결을 확인하고, 사용하려는 라이브러리 이름과 버전이 Cargo.toml의 [dependencies] 섹션에 정확히 적혀 있는지 확인하세요.
❌ 실수: Rust 버전을 업데이트했는데 갑자기 기존 코드가 컴파일되지 않아요.
왜 발생하는가: 새로운 버전에서 더 엄격해진 규칙(Edition 변화 등)이 적용되었을 수 있어요.
✅ 해결법: rustup update를 통해 최신 상태를 유지하되, 특정 버전에 고정해야 한다면 rustup override set 명령어를 사용하세요.
자주 묻는 질문
Q. Rustup과 Cargo는 꼭 따로 설치해야 하나요?
아니요, Rustup을 통해 설치하면 Cargo는 자동으로 따라와요. Rustup은 전체적인 관리자 역할을 하고, Cargo는 그 안에서 실제 작업을 수행하는 일꾼이라고 생각하면 돼요.
Q. 맥(macOS) 사용자는 M1/M2 칩을 쓰는데 주의할 점이 있나요?
최신 Rust 버전은 Apple Silicon을 완벽하게 지원해요. 다만, 설치 시 아키텍처가 ‘aarch64-apple-darwin’으로 잘 잡혔는지 확인하는 것이 성능 면에서 훨씬 유리해요.
Q. 리눅스에서 루트(root) 권한으로 설치해야 하나요?
아니요, 가급적이면 일반 사용자 권한으로 설치하는 것을 권장해요. Rustup은 사용자의 홈 디렉토리에 설치되므로 시스템 전체를 건드리지 않고도 안전하게 관리할 수 있어요.
Q. C언어로 된 라이브러리를 Rust에서 쓰고 싶으면 어떻게 하나요?
이것은 꽤 고급 주제지만, 기본적으로 ‘FFI(Foreign Function Interface)’라는 기술을 사용해요. Cargo를 통해 해당 라이브러리를 연결하는 설정이 필요합니다.
Q. Rust를 배우다가 환경이 너무 꼬이면 어떻게 하죠?
가장 깔끔한 방법은 rustup self uninstall 명령어로 모든 것을 지우고, 처음부터 다시 시작하는 거예요. 생각보다 금방 끝나요!
성공적인 Rust 시작을 위한 마지막 점검
지금까지 Rust 설치와 환경설정, 그리고 마이그레이션 과정까지 모두 살펴보았어요. 처음에는 복잡해 보였을지 모르지만, 한 번 제대로 구축해 놓은 환경은 여러분이 앞으로 수천, 수만 줄의 코드를 작성할 때 든든한 버팀목이 되어줄 거예요. 환경 설정의 어려움 때문에 Rust라는 강력한 무기를 포기하지 마세요. 그 고비만 넘기면 정말 즐거운 개발 세계가 기다리고 있으니까요.
- 운영체제별 필수 빌드 도구(MSVC, Xcode 등)를 먼저 확인하세요.
- Rustup을 통해 표준적인 방식으로 설치하는 것이 가장 안전해요.
- 설치 후에는 반드시 터미널을 재시작하여 환경 변수를 적용하세요.
- VS Code 사용 시 ‘rust-analyzer’ 확장을 꼭 사용하세요.
- Cargo를 이용해 첫 프로젝트를 실행하며 환경을 검증하세요.
자, 이제 여러분이 해야 할 일은 명확해요. 오늘 바로 터미널을 열고 명령어를 입력해 보세요. 막히는 부분이 있다면 이 글의 오류 해결 섹션을 다시 한번 훑어보는 것도 잊지 마시고요.
- 오늘 할 일: 운영체제에 맞는 Rustup 설치 실행하기
- 이번 주 할 일: VS Code와 연동하여 ‘Hello World’ 출력 성공시키기
- 실행 직전 할 일: 공식 문서를 옆에 띄워두고 Cargo 명령어 익히기
안전하게 Rust 설치와 환경설정을 마쳤다면, 이제 여러분은 준비된 개발자입니다. 더 깊이 있는 학습을 원하신다면 Rust 입문 학습 가이드나 Cargo 활용법에 관한 다른 글들도 함께 읽어보시는 것을 추천해요. 여러분의 새로운 도전을 진심으로 응원합니다!
