[IT-정보] Rust 설치와 환경설정 개념 완벽 가이드 – 입문자를 위한 핵심 용어부터 실습 예제까지

Rust 설치와 환경설정, 왜 첫 단추가 중요할까요

새로운 프로그래밍 언어를 배우기로 마음먹고 야심 차게 터미널을 열었는데, “command not found: rustc”라는 차가운 메시지를 마주했을 때의 막막함을 기억하시나요? 저도 처음 Rust를 공부할 때 똑같은 경험을 했어요. 단순히 설치 프로그램을 실행했다고 끝나는 것이 아니라, 도구들이 서로 어떻게 연결되어 있는지 모르면 작은 오류 하나에도 금방 길을 잃기 마련이에요.

Rust는 메모리 안전성과 성능을 동시에 잡은 아주 매력적인 언어지만, 그만큼 환경 구성이 까다로운 편에 속해요. 컴파일러와 패키지 매니저, 그리고 개발 도구가 유기적으로 맞물려 돌아가야 비로소 제대로 된 코딩을 시작할 수 있거든요. 환경 설정 단계에서 겪는 시행착오는 단순한 시간 낭비를 넘어, 언어 자체에 대한 흥미를 떨어뜨리는 원인이 되기도 해요.

그래서 오늘은 여러분이 설치 과정에서 겪을 수 있는 혼란을 최소화하려고 해요. 단순히 명령어만 나열하는 것이 아니라, Rust 설치와 환경설정 개념을 근본적으로 이해할 수 있도록 돕는 것이 이 글의 목적이에요. 이 가이드를 끝까지 따라오신다면, 복잡한 오류 메시지 대신 깔끔하게 돌아가는 여러분의 개발 환경을 마주하게 될 거예요.

이 글을 통해 여러분은 다음 내용을 확실히 배우게 돼요.

• Rust 생태계를 지탱하는 핵심 도구들의 역할 이해
• 운영체제별 최적화된 설치 방법 습득
• Cargo를 활용한 프로젝트 관리 실습
• 개발 효율을 높여주는 IDE 환경 구성

설치 전 반드시 알아야 할 핵심 개념과 준비물

본격적으로 설치 버튼을 누르기 전에, 우리가 다루게 될 도구들이 무엇인지 명확히 알고 넘어가야 해요. 용어를 모른 채 명령어를 입력하는 것은 지도 없이 정글에 들어가는 것과 다름없으니까요. Rust 개발 환경은 크게 도구 관리자, 컴파일러, 패키지 매니저라는 세 가지 축으로 움직여요.

Rust 생태계의 3대 핵심 요소

가장 먼저 만날 도구는 Rustup이에요. 이는 Rust의 버전들을 관리하고, 필요한 도구 모음을 설치해 주는 관리자 역할을 해요. 마치 스마트폰의 앱스토어처럼, 우리가 필요한 Rust 버전을 쉽게 내려받고 업데이트할 수 있게 도와주죠.

그다음은 rustc라는 컴파일러예요. 우리가 작성한 코드를 컴퓨터가 이해할 수 있는 기계어로 번역해 주는 아주 똑똑한 친구예요. 마지막으로 가장 많이 쓰게 될 Cargo는 패키지 매니저이자 빌드 도구예요. 외부 라이브러리를 가져오거나 프로젝트를 생성하고 실행하는 모든 과정을 Cargo가 담당한다고 생각하면 쉬워요.

운영체제별 설치 환경 비교

사용 중인 컴퓨터의 운영체제에 따라 준비해야 할 것이 조금씩 달라요. 특히 Windows 사용자는 설치 전에 빌드 도구에 대한 이해가 꼭 필요해요. 아래 표를 통해 본인의 환경에 맞는 준비 사항을 확인해 보세요.

특히 Windows 사용자라면 Visual Studio C++ 빌드 도구가 설치되어 있지 않을 때 발생하는 오류를 자주 보게 될 거예요. Rust 컴파일러는 코드를 기계어로 바꿀 때 시스템의 링크 기능을 사용하는데, Windows에서는 이 역할을 MSVC가 수행하기 때문이죠. 따라서 설치 과정 중에 관련 도구를 설치하라는 안내가 나오면 주저하지 말고 따라해 주셔야 해요.

단계별 실행: Rust 개발 환경 완벽 구축하기

이제 준비는 끝났어요. 직접 손을 움직여서 개발 환경을 만들어 볼 차례예요. 각 단계를 하나씩 차근차근 따라오시면 큰 어려움 없이 성공하실 수 있을 거예요.

STEP 1. Rustup을 이용한 도구 모음 설치하기

가장 먼저 해야 할 일은 Rust의 관리자인 Rustup을 설치하는 거예요. 운영체제에 따라 방법이 다르니 본인에게 맞는 방식을 선택해 주세요.

Windows 사용자라면: rustup.rs 공식 사이트에 접속해서 rustup-init.exe 파일을 내려받으세요. 파일을 실행하면 검은색 터미널 창이 나타날 거예요. 이때 화면에 나타나는 안내 문구를 잘 읽어보세요. 대부분의 경우 1번을 눌러 기본 설치(default)를 진행하면 되지만, 만약 Visual Studio 빌드 도구가 없다면 설치하라는 안내가 나올 거예요. 그 안내에 따라 MSVC를 먼저 설치한 뒤 다시 진행해야 해요.

macOS 및 Linux 사용자라면: 터미널을 열고 아래 명령어를 입력해 주세요.

설치가 완료되면 터미널을 완전히 종료했다가 다시 열어주세요. 그래야 새로 설치된 도구들이 시스템에 인식돼요.

STEP 2. 환경 변수와 경로 확인하기

설치가 끝났다고 해서 바로 코딩을 시작할 수 있는 건 아니에요. 컴퓨터가 rustc나 cargo 명령어를 알아들을 수 있도록 경로(PATH)가 제대로 설정되었는지 확인해야 해요. 터미널(또는 CMD, PowerShell)에서 다음 명령어를 입력해 보세요.

rustc --version

명령어를 쳤을 때 rustc 1.xx.x (hash date)와 같은 버전 정보가 출력된다면 성공이에요! 만약 “명령어를 찾을 수 없습니다”라는 메시지가 뜬다면, 설치 경로가 시스템 환경 변수에 등록되지 않은 상태예요. 이럴 때는 컴퓨터를 재부팅하거나, 사용자의 홈 디렉터리에 있는 .cargo/bin 폴더가 PATH에 포함되어 있는지 직접 확인해야 해요.

STEP 3. Cargo로 첫 프로젝트 생성하고 실행하기

이제 진짜 Rust 프로그래밍의 꽃, Cargo를 사용해 볼 시간이에요. Cargo는 단순히 명령어를 실행하는 것을 넘어, 프로젝트의 구조를 잡고 라이브러리를 관리하는 아주 강력한 도구예요.

먼저, 공부할 폴더를 하나 만들고 그 안에서 터미널을 여세요. 그런 다음 아래 명령어를 입력해 보세요.

cargo new hello_rust

이 명령어를 실행하면 hello_rust라는 이름의 새 폴더가 생겨요. 폴더 안을 들여다보면 Cargo.toml 파일과 src/main.rs 파일이 생성된 것을 볼 수 있어요. Cargo.toml은 프로젝트의 설정 파일이고, main.rs가 바로 우리가 코드를 작성할 공간이에요.

폴더 안으로 들어간 뒤, 다음 명령어를 입력해 보세요.

cd hello_rust
cargo run

이 명령어는 컴파일과 실행을 한 번에 처리해 줘요. 터미널에 “Hello, world!”라는 문구가 나타난다면, 여러분은 드디어 Rust 개발자가 될 준비를 마친 거예요!

STEP 4. VS Code와 rust-analyzer로 개발 환경 완성하기

검은 터미널 창에서만 코딩할 수는 없겠죠? 생산성을 극대화하기 위해 Visual Studio Code(VS Code)를 사용하는 것을 강력히 추천해요. 하지만 VS Code만 설치한다고 끝나는 게 아니에요. Rust 개발에 최적화된 확장 프로그램을 반드시 설치해야 해요.

먼저 VS Code를 실행하고 왼쪽의 확장 프로그램(Extensions) 아이콘을 클릭하세요. 검색창에 rust-analyzer를 입력하고 설치해 주세요. 과거에는 ‘Rust’라는 이름의 확장 프로그램이 쓰였지만, 지금은 훨씬 빠르고 강력한 rust-analyzer가 표준이에요. 이 확장 프로그램을 설치하면 코드 자동 완성, 실시간 오류 검사, 타입 힌트 등을 제공받을 수 있어 마치 옆에서 고수가 코칭해 주는 듯한 경험을 할 수 있어요.

STEP 5. 실제 코드로 확인하는 설치 결과

환경이 잘 갖춰졌는지 확인하기 위해 간단한 계산기 코드를 작성해 볼까요? src/main.rs 파일을 열고 기존 내용을 모두 지운 뒤 아래 코드를 복사해서 붙여넣어 보세요.

fn main() {
    let a = 10;
    let b = 20;
    let sum = a + b;
    println!("{}와 {}의 합은 {}입니다!", a, b, sum);
}

다시 터미널로 돌아와 cargo run을 입력해 보세요. 결과가 예상대로 나온다면 여러분의 Rust 설치와 환경설정 개념은 완벽하게 실전으로 이어지고 있는 거예요.

자주 하는 실수와 해결법 및 FAQ

설치 과정은 순탄해 보이지만, 예상치 못한 곳에서 막힐 때가 많아요. 입문자들이 가장 자주 겪는 문제들을 정리했으니, 비슷한 상황이 발생하면 바로 확인해 보세요.

자주 하는 실수와 해결법

❌ Windows에서 컴파일 오류가 나며 ‘linker’ 관련 메시지가 떠요
왜 발생할까: Rust가 코드를 기계어로 바꾼 뒤, 시스템 라이브러리와 연결할 때 필요한 C++ 빌드 도구가 없기 때문이에요.
✅ 해결법: Visual Studio Installer를 실행하여 “C++를 사용한 데스크톱 개발” 워크로드를 반드시 설치해 주세요.

❌ 명령어를 입력했는데 ‘command not found’가 나와요
왜 발생할까: Rust 설치 경로가 시스템의 PATH 환경 변수에 등록되지 않았거나, 터미널을 새로 고치지 않았기 때문이에요.
✅ 해결법: 터미널을 완전히 끄고 다시 켜거나, 컴퓨터를 재부팅하세요. 그래도 안 되면 source $HOME/.cargo/env 명령어를 사용해 보세요.

❌ Cargo.toml 파일에 라이브러리를 추가했는데 인식이 안 돼요
왜 발생할까: 파일의 문법이 틀렸거나, 라이브러리를 추가한 후 프로젝트를 다시 빌드하지 않았을 수 있어요.
✅ 해결법: 파일의 인덴트(들여쓰기)를 확인하고, 반드시 cargo build를 실행하여 의존성을 새로 내려받으세요.

❌ VS Code에서 코드에 빨간 줄이 계속 떠요
왜 발생할까: rust-analyzer 확장 프로그램이 아직 프로젝트를 분석 중이거나, 설치가 제대로 안 되었을 수 있어요.
✅ 해결법: 오른쪽 하단의 상태 표시줄에서 rust-analyzer의 작업 상태를 확인하고, 완료될 때까지 잠시 기다려 주세요.

❌ Rust 버전을 업데이트하고 싶은데 어떻게 하나요?
왜 발생할까: 그냥 설치만 하고 방치하면 구버전의 버그나 최신 기능 부재를 겪게 돼요.
✅ 해결법: 터미널에 rustup update를 입력하면 아주 간단하게 해결돼요.

자주 묻는 질문

Q. rustc와 cargo 중 무엇을 더 많이 쓰게 되나요?

대부분의 실무에서는 Cargo를 압도적으로 많이 사용해요. rustc는 아주 간단한 단일 파일을 컴파일할 때나 쓰이지만, 프로젝트 규모가 조금만 커져도 의존성 관리와 빌드 자동화를 위해 Cargo가 필수적이기 때문이에요.

Q. 왜 굳이 Rustup을 써서 설치해야 하나요? 그냥 직접 설치하면 안 되나요?
직접 설치하면 버전 관리나 도구 업데이트가 매우 힘들어져요. Rustup을 쓰면 명령어 한 줄로 최신 버전 유지와 다양한 환경(stable, beta, nightly) 전환이 가능해서 훨씬 효율적이에요.

Q. Mac에서 M1/M2/M3 칩을 쓰는데 설치 시 주의할 점이 있나요?
최신 Apple Silicon을 지원하므로 매우 잘 작동해요. 다만, 설치 시 Xcode Command Line Tools가 최신 상태인지 꼭 확인해 주세요. 그렇지 않으면 아키텍처 불일치 오류가 날 수 있어요.

Q. 프로젝트 폴더를 지우면 어떻게 되나요?
프로젝트 폴더를 지우면 작성한 코드와 해당 프로젝트를 위한 라이브러리 파일들이 모두 사라져요. 하지만 이미 Crates.io에서 내려받은 공용 라이브러리들은 컴퓨터의 캐시 폴더에 남아있으므로, 나중에 새 프로젝트를 만들 때 다시 빠르게 내려받을 수 있어요.

Q. 학습하기 가장 좋은 순서는 무엇인가요?
환경 설정이 끝났다면 바로 ‘The Rust Programming Language'(공식 문서)를 읽기 시작하는 것을 추천해요. 처음에는 소유권(Ownership) 개념이 어렵겠지만, 직접 코드를 짜보며 Cargo로 실행해 보는 과정이 병행되어야 실력이 늘어요.

성공적인 Rust 시작을 위한 마무리

지금까지 Rust 설치부터 개발 환경 구성, 그리고 실제 첫 프로젝트 실행까지 모든 과정을 살펴보았어요. 처음에는 낯선 용어와 터미널 환경이 조금 두렵게 느껴질 수 있지만, 한 번 제대로 잡아놓은 환경은 여러분의 코딩 여정을 훨씬 가볍게 만들어 줄 거예요.

오늘의 배움을 바탕으로 다음 단계로 나아갈 준비가 되셨나요? 무작정 이론만 공부하기보다는, 작은 기능이라도 직접 구현해 보는 것이 가장 빠른 길이에요.

지금 바로 실천해 보세요

• 오늘 할 일: Rustup 설치를 완료하고 cargo run으로 Hello World 출력하기
• 이번 주 할 일: VS Code 확장 프로그램을 설치하고 간단한 사칙연산 프로그램 만들기
• 실행 직전 할 일: 공식 문서의 ‘Ownership’ 챕터 가볍게 읽어보기

어렵게 느껴졌던 Rust 설치와 환경설정, 오늘 확실히 정리해 보셨나요? 이제 여러분 앞에는 무한한 가능성을 가진 Rust의 세계가 펼쳐져 있어요. 막히는 부분이 있다면 언제든 다시 이 글을 찾아와 도움을 얻으시길 바라요!

함께 읽으면 좋은 글: 입문자를 위한 Rust 프로그래밍 학습 가이드, Rust 소유권 개념 완벽 이해하기