Rust 설치하고 cargo 로 첫 프로그램 돌리기

Rust 는 rustup 설치 명령 한 줄로 컴파일러 rustc 와 빌드 도구 cargo 가 함께 깔린다. 프로젝트는 cargo new 로 만들고 cargo run 으로 돌린다. 이 시리즈의 예제는 모두 rustc 1.95.0(edition 2024)으로 실행했고, 출력과 오류 메시지는 고치지 않고 그대로 붙였다.

01 Rust 는 틀린 코드를 컴파일할 때 돌려보낸다

Rust 는 타입이 안 맞거나 메모리를 잘못 다루는 코드를 실행하기 전에, 컴파일 단계에서 막는다. 가비지 컬렉터 없이도 메모리를 안전하게 쓰는 방법이 이것이다.

그래서 처음에는 컴파일 오류를 자주 본다. 대신 오류 메시지가 친절해서 고치는 방법까지 적어 주는 일이 많다. 이 시리즈는 한 편에 주제 하나씩, 직접 돌려 본 결과를 보면서 나아간다.

02 설치는 명령 한 줄이다

macOS·Linux 에서는 아래 명령을 터미널에 붙여 넣고, 안내가 나오면 기본값을 고른다.

bash

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

설치가 끝나면 터미널을 새로 열고 버전을 확인한다.

bash

rustc --version && cargo --version

text

rustc 1.95.0 (59807616e 2026-04-14)
cargo 1.95.0 (f2d3ce0bd 2026-03-21)

명령을 못 찾는다고 나오면 터미널을 한 번 더 새로 연다. 나중에 새 판으로 올릴 때는 rustup update 를 친다.

03 cargo new 로 프로젝트를 만든다

bash

cargo new hello
cd hello

hello 폴더 안에 파일 두 개가 생긴다.

Cargo.toml — 프로젝트 이름과 설정
src/main.rs — 소스 코드

toml

[package]
name = "hello"
version = "0.1.0"
edition = "2024"

[dependencies]

edition = "2024" 는 이 프로젝트가 따르는 Rust 문법의 판이다. 지금은 신경 쓰지 않아도 된다. src/main.rs 에는 인사 한 줄이 이미 들어 있다.

rust

fn main() {
    println!("Hello, world!");
}

fn main() 은 프로그램이 시작하는 함수다. println! 은 화면에 한 줄을 찍는다. 끝의 느낌표는 함수가 아니라 매크로라는 표시인데, 지금은 "출력할 때 쓰고, 느낌표가 붙는다" 만 기억하면 된다.

04 cargo run 으로 돌린다

hello 폴더 안에서 cargo run 을 치면 컴파일하고 바로 실행한다.

bash

cargo run

text

   Compiling hello v0.1.0 (~/projects/hello)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.71s
     Running `target/debug/hello`
Hello, world!

앞의 세 줄은 cargo 가 찍은 진행 상황이고, 마지막 줄이 프로그램이 찍은 것이다. 출력의 ~/projects/hello 는 프로젝트를 만든 자리를 줄여 쓴 것이고, 나머지는 터미널에 나온 그대로다.

05 실습 — 한 줄 더 찍어 본다

src/main.rs 를 열어 println! 한 줄을 더 넣는다. 따옴표 안의 글자는 마음대로 바꿔도 된다.

rust

fn main() {
    println!("Hello, world!");
    println!("Hello, Rust!");
}

저장하고 다시 cargo run 을 치면, cargo 가 바뀐 것을 알아채고 새로 컴파일한 뒤 두 줄을 찍는다.

text

   Compiling hello v0.1.0 (~/projects/hello)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.16s
     Running `target/debug/hello`
Hello, world!
Hello, Rust!

설치부터 실행까지가 이것으로 끝이다. 다음 편에서는 일부러 틀린 코드를 넣어 보고, 컴파일 오류를 읽는 법을 익힌다.

06 자주 묻는 질문

Windows 에서는 어떻게 설치하나?

공식 설치 페이지에서 rustup-init.exe 를 받아 실행한다. Visual Studio 빌드 도구를 설치하라는 안내가 나오면 함께 설치한다. WSL 을 쓴다면 위의 curl 명령을 그대로 쓰면 된다.