Rust 01. 설치와 Hello World 실행하기
요약
Rust를 처음 시작할 때는 컴파일러만 따로 찾기보다 공식 설치 도구인 rustup으로 한 번에 설치하는 편이 가장 단순하다. 이 글은 Windows와 VS Code 기준으로 Rust 설치, 버전 확인, rustc 단일 파일 실행, cargo 프로젝트 실행까지 가장 짧은 입문 경로를 정리한다.
결론부터 말하면 “설치는 rustup, 빠른 단일 파일 실습은 rustc, 실제 프로젝트 시작은 cargo“로 구분해 이해하면 가장 덜 헷갈린다.
문서 정보
- 작성일: 2026-04-07
- 검증 기준일: 2026-04-15
- 문서 성격: tutorial
- 테스트 환경: Windows PowerShell, VS Code,
rustup,rustc,cargo - 테스트 버전: rustc 1.94.0, cargo 1.94.0
- 출처 등급: 공식 문서만 사용했다.
- 비고: 설치 화면과 설치기 UI는 시점에 따라 바뀔 수 있다. 이 글은 Windows 로컬 환경 기준의 가장 기본 흐름만 다룬다.
문제 정의
Rust 입문 단계에서 가장 먼저 헷갈리는 지점은 아래 세 가지다.
- Rust를 설치한다는 말이
rustc설치를 뜻하는지rustup설치를 뜻하는지 모호하다. rustc와cargo가 각각 언제 필요한지 감이 잘 안 잡힌다.- 설치가 끝난 뒤 무엇을 실행해야 “정상 설치”라고 볼 수 있는지 불분명하다.
이 글은 위 혼란을 줄이기 위해 설치, 버전 확인, Hello, world! 실행까지 최소 경로만 정리한다. 고급 설치 옵션, WSL, macOS/Linux, toolchain override 같은 주제는 범위에서 제외한다.
읽는 기준은 단순하다. rustup은 설치와 업데이트를 맡는 입구, rustc는 컴파일러가 실제로 동작하는지 확인하는 도구, cargo는 프로젝트를 만들고 실행하는 도구로 나눠 보면 된다. 이 글에서는 세 도구의 모든 옵션을 외우기보다 “언제 어떤 도구를 호출하는가”만 잡으면 충분하다.
확인된 사실
- 공식 설치 페이지와
rustup사이트는 Rust 설치를rustup경로로 안내한다. 근거: Install Rust, rustup.rs 의미: 여기서 설치한다는 말은rustc실행 파일 하나만 받는다는 뜻이 아니라, Rust toolchain을 관리하는 기본 경로를 준비한다는 뜻이다. - Rust Book의 설치 장은 설치 후
rustc --version으로 설치를 확인하는 흐름을 설명한다. 근거: Installation 의미: 이 명령이 동작하면 터미널에서 Rust 컴파일러를 찾을 수 있고, PATH와 기본 toolchain 연결이 최소한 정상이라는 뜻으로 읽을 수 있다. - Rust Book은 단일 파일 예제를
rustc로 컴파일하는 흐름과, 실제 프로젝트 흐름을cargo new,cargo build,cargo run기준으로 구분해 설명한다. 근거: Hello, World!, Hello, Cargo! 의미:rustc와cargo는 경쟁 관계가 아니다.rustc는 컴파일러이고,cargo는 프로젝트 생성, 빌드, 실행, 의존성 관리를 묶어 주는 작업 도구다. - VS Code의 공식 Rust 문서는 편집 확장으로
rust-analyzer를 안내한다. 근거: Rust in Visual Studio Code 의미:rust-analyzer는 Rust를 설치하는 도구가 아니라 에디터가 Rust 코드를 이해하도록 돕는 분석 레이어다.
직접 재현한 결과
1. 설치 경로와 버전 확인
- 직접 확인한 결과: 공식 사이트에서 Windows용
rustup-init.exe를 실행하고 기본 설치를 선택한 뒤, 새 PowerShell 창에서 아래 명령으로 설치를 확인할 수 있었다.
rustc --version
cargo --version
- 관찰된 결과:
rustc 1.94.0 (4a4ef493e 2026-03-02)
cargo 1.94.0 (85eff7c80 2026-01-15)
-
읽는 법: 두 명령이 모두 버전을 출력하면 설치 자체와 터미널 연결은 통과한 것으로 볼 수 있다. 여기서 나온 버전은 이후 예제 결과를 판단하는 기준이므로, 다른 버전에서 메시지 문구가 조금 달라도 핵심 흐름이 같으면 같은 단계로 보면 된다.
-
재현 순서는 아래처럼 따라가면 된다.
- Rust install page 또는 rustup.rs로 들어간다.
- Windows용
rustup-init.exe를 내려받아 실행한다. - 기본값 기준으로
1) Proceed with standard installation을 선택한다. - 설치 후 새 PowerShell 창을 열고 위 버전 확인 명령을 실행한다.
2. VS Code에서 가장 단순한 Hello World 코드 준비
- 직접 확인한 결과: 새 폴더를 VS Code로 열고
hello.rs파일에 아래 코드를 넣으면 단일 파일 실습을 바로 시작할 수 있었다.
fn main() {
println!("Hello, world!");
}
- 직접 확인한 결과: VS Code에서 Rust를 계속 볼 예정이라면
rust-analyzer를 함께 설치해 두는 편이 편집 경험이 훨씬 낫다.
3. rustc로 단일 파일 빌드
- 직접 확인한 결과:
hello.rs가 있는 폴더에서 아래 명령을 실행하면 같은 폴더에hello.exe가 생성됐다.
rustc hello.rs
.\hello.exe
- 관찰된 결과:
Hello, world!
- 읽는 법:
rustc hello.rs는 한 파일을 곧바로 실행 파일로 바꾸는 가장 짧은 확인 경로다. 다만 이 경로는 “Rust 문법을 한 파일로 빨리 확인”할 때는 간단하지만, 프로젝트 구조나 의존성 관리는 다루지 않는다.
4. cargo로 프로젝트 생성과 실행
- 직접 확인한 결과: 실제 프로젝트 흐름은
cargo가 훨씬 자연스러웠다. 아래 명령으로 새 프로젝트를 만들고 바로 실행할 수 있었다.
cargo new hello-rust
cd hello-rust
cargo run
src/main.rs의 기본 코드는 아래처럼 시작한다.
fn main() {
println!("Hello, world!");
}
- 관찰된 결과:
Hello, world!
-
읽는 법:
cargo run은 필요한 빌드를 수행한 뒤 실행까지 이어 주므로, 초급자는 “프로젝트를 만든 뒤 반복 실행하는 기본 명령”으로 이해하면 된다. -
직접 확인한 결과:
cargo build를 쓰면 실행 파일은target\debug\hello-rust.exe아래 생성됐다.
해석 / 의견
- 이 단계에서 중요한 판단: 입문 단계에서는 Rust 설치를 “
rustup으로 toolchain을 설치한다”로 이해하는 편이 가장 실용적이다. - 선택 기준: 단일 파일 문법 확인은
rustc, 계속 수정하고 키울 코드는cargo로 시작한다. - 권장 흐름: 초급자 기준으로는 “설치 확인 ->
rustc한 번 실행 ->cargo new로 프로젝트 시작” 순서가 가장 자연스럽다.
한계와 예외
- 이 글은 Windows PowerShell과 VS Code 기준이다. macOS, Linux, WSL, Remote Container 환경은 다루지 않았다.
rustup-init.exe화면 구성과 기본 옵션은 시점에 따라 달라질 수 있다.- 이 글은 설치와 첫 실행만 다룬다. toolchain override, nightly, cross-compilation, C++ 빌드 도구 이슈 같은 설치 예외는 넣지 않았다.
- VS Code 사용은 선택 사항이다. Rust 설치와
rustc/cargo실행 자체는 에디터 없이도 가능하다. - 이 글을 읽고도 남는 질문은 “여러 toolchain을 어떻게 바꾸는가”, “nightly는 언제 쓰는가”, “플랫폼별 native build tool 문제를 어떻게 푸는가”이며, 이는 설치 심화 주제로 분리하는 편이 맞다.
댓글남기기