[IT-정보] Rust 설치와 환경설정 가이드 – 입문자를 위한 단계별 실전 예제

Rust 설치와 환경설정, 왜 제대로 시작해야 할까요?

C++을 사용하다가 원인을 알 수 없는 메모리 오류 때문에 밤을 지새운 적이 있으신가요? 세그멘테이션 폴트(Segmentation Fault) 메시지를 마주할 때의 막막함은 개발자라면 누구나 공감할 거예요. 그렇다고 파이썬처럼 편한 언어를 쓰자니 실행 속도가 너무 느려서 고민이 되기도 하죠. 이 두 가지 고민을 동시에 해결해 줄 수 있는 강력한 무기가 바로 Rust예요.

하지만 새로운 언어를 배울 때 가장 큰 진입장벽은 의외로 언어 자체보다 개발 환경을 구축하는 과정에서 나타나곤 해요. 컴파일러 버전이 맞지 않거나, 환경 변수가 꼬여서 명령어가 먹히지 않을 때의 답답함은 공부 의욕을 꺾어버리기 일쑤예요. 특히 Rust는 도구들이 유기적으로 연결되어 있어서, 첫 단추를 잘못 끼우면 나중에 라이브러리를 추가할 때마다 계속해서 오류를 마주하게 돼요.

이 글은 그런 시행착오를 줄여드리기 위해 준비했어요. 단순히 설치 파일을 다운로드하는 법을 넘어, 여러분의 컴퓨터가 Rust 코드를 완벽하게 이해하고 실행할 수 있는 상태로 만드는 모든 과정을 상세히 안내해 드려요. 환경 구축이 끝난 후에는 바로 코드를 작성해 볼 수 있도록 실전 예제까지 포함했어요.

설치 전 꼭 알아야 할 핵심 개념과 준비물

본격적인 설치에 들어가기 전에, 우리가 다룰 도구들이 각각 어떤 역할을 하는지 이해하는 것이 중요해요. 용어를 미리 익혀두면 나중에 에러 메시지를 읽을 때 훨씬 수월하게 대처할 수 있어요. Rust 생태계는 매우 체계적으로 구성되어 있거든요.

Rust 개발의 3대 핵심 도구

가장 먼저 기억해야 할 것은 rustup, rustc, 그리고 Cargo예요. 이 세 가지는 서로 긴밀하게 협력하며 여러분의 코드를 실제 프로그램으로 만들어줘요.

• rustup: Rust의 버전 관리 도구예요. 새로운 버전이 나오면 명령 한 줄로 업데이트할 수 있게 도와주고, 다양한 운영체제 환경에 맞는 툴체인을 설치해 줘요.
• rustc: 실제 Rust 코드를 기계어로 번역하는 컴파일러예요. 하지만 우리는 이 명령어를 직접 입력하기보다 Cargo를 통해 간접적으로 사용하는 경우가 더 많아요.
• Cargo: Rust의 진정한 마법사예요. 프로젝트를 생성하고, 외부 라이브러리를 가져오고, 빌드와 실행을 한꺼번에 관리하는 패키지 매니저이자 빌드 도구예요.

운영체제별 환경 선택 가이드

사용 중인 컴퓨터의 운영체제에 따라 준비해야 할 사항이 조금씩 달라요. 아래 표를 보고 본인의 환경에 맞는 준비물을 미리 체크해 보세요.

Windows 사용자의 경우, 가장 흔하게 하는 실수가 C++ 컴파일 환경을 갖추지 않고 Rust만 설치하려 하는 거예요. Rust는 코드를 기계어로 바꾸기 위해 운영체제가 제공하는 기본 빌드 도구들을 빌려 쓰거든요. 따라서 Visual Studio Build Tools가 미리 설치되어 있어야 오류 없이 진행할 수 있어요.

실전! 단계별 Rust 설치 및 환경 구성하기

이제 준비는 끝났어요. 실제로 명령어를 입력하며 여러분의 컴퓨터에 Rust를 심어줄 시간이에요. 단계별로 차근차근 따라오시면 누구나 성공할 수 있어요.

STEP 1. 운영체제별 설치 명령어 실행하기

모든 설치의 핵심은 rustup을 사용하는 것이에요. 운영체제에 맞는 방법을 선택해서 터미널(또는 명령 프롬프트)에 입력해 주세요.

Windows 사용자

Windows에서는 웹 브라우저를 통해 설치 파일을 받는 것이 가장 편해요. rustup-init.exe 파일을 다운로드한 후 실행해 주세요. 이때 반드시 주의할 점은 설치 과정 중에 Visual Studio Build Tools가 설치되어 있는지 확인하는 것이에요. 만약 설치되어 있지 않다면 안내 문구가 뜰 거예요. 안내에 따라 Visual Studio 설치 관리자를 실행하고 ‘C++를 사용한 데스크톱 개발’ 워크로드를 반드시 체크해서 설치를 완료해 주세요.

macOS 및 Linux 사용자

터미널을 열고 아래의 명령어를 복사해서 붙여넣기만 하면 돼요. 매우 간단하죠?

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

명령어를 입력하면 여러 선택지가 나올 텐데, 대부분의 경우 1번(default installation)을 선택하고 Enter를 누르면 돼요. 설치가 완료될 때까지 잠시 기다려 주세요.

STEP 2. 환경 변수 적용 및 설치 확인하기

설치가 끝났다고 해서 바로 명령어를 쓸 수 있는 건 아니에요. 설치된 도구들의 위치를 컴퓨터가 알 수 있도록 경로(Path)를 업데이트해줘야 해요. 터미널을 완전히 종료했다가 다시 실행하는 것만으로도 충분해요.

제대로 설치되었는지 확인하려면 아래 두 명령어를 각각 입력해 보세요. 버전 숫자가 출력된다면 성공이에요!

• rustc --version
• cargo --version

만약 ‘command not found’라는 메시지가 나온다면, 환경 변수 설정이 누락된 것이니 당황하지 말고 source $HOME/.cargo/env 명령어를 입력하거나 컴퓨터를 재부팅해 보세요.

STEP 3. 최적의 개발 환경(IDE) 구축하기

코드를 메모장에 쓸 수는 없겠죠? 가장 추천하는 조합은 Visual Studio Code(VS Code)와 rust-analyzer 확장 기능이에요. 이 조합은 전 세계 Rust 개발자들이 가장 많이 사용하는 표준 구성이에요.

1. VS Code를 실행하고 왼쪽 사이드바의 확장(Extensions) 아이콘을 클릭해요.
2. 검색창에 rust-analyzer를 입력하고 설치 버튼을 눌러요.
3. 설치가 완료되면 코드 작성 시 자동 완성, 타입 힌트, 실시간 에러 체크 기능을 즉시 사용할 수 있어요.

이 도구를 사용하면 코드를 치는 중간에 빨간 줄이 그어지며 실수를 바로 잡아주기 때문에 학습 속도가 비약적으로 빨라져요.

STEP 4. Cargo로 첫 프로젝트 생성 및 코드 작성

이제 모든 준비가 끝났으니 첫 번째 프로그램을 만들어 볼까요? Cargo를 이용하면 폴더 생성부터 컴파일까지 아주 깔끔하게 처리할 수 있어요. 터미널에서 프로젝트를 만들고 싶은 폴더로 이동한 뒤 아래 명령어를 입력해 주세요.

cargo new hello_rust

명령어를 실행하면 hello_rust라는 폴더가 생기고, 그 안에 기본적인 파일 구조가 자동으로 만들어져요. 생성된 폴더로 들어가서 src/main.rs 파일을 열어 보세요. 이미 기본적인 ‘Hello, world!’ 코드가 작성되어 있을 거예요.

STEP 5. 컴파일과 실행 실습하기

작성한 코드가 실제로 어떻게 돌아가는지 확인해 볼 차례예요. 터미널에서 프로젝트 루트 폴더(hello_rust 폴더)에 위치한 상태로 다음 명령어를 입력해 보세요.

cargo run

잠시 기다리면 코드가 컴파일되고, 화면에 Hello, world!라는 문구가 출력되는 것을 볼 수 있어요. 이 과정에서 Cargo는 소스 코드를 읽고, 필요한 라이브러리를 확인하며, 최종적으로 실행 가능한 파일을 만들어 실행까지 한 번에 처리해 준 거예요. 정말 편리하죠?

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

설치 과정에서 예상치 못한 오류를 만나면 당황하기 마련이에요. 하지만 대부분의 문제는 이미 많은 개발자가 겪었던 문제들이니 아래 내용을 참고해서 해결해 보세요.

자주 하는 실수와 해결법

• ❌ linker ‘link.exe’ not found 에러 → Windows에서 Visual Studio Build Tools가 설치되지 않았을 때 발생해요. ✅ MSVC 툴체인을 설치하거나, 만약 다른 방식을 원한다면 GNU 툴체인으로 설정을 변경해야 해요.
• ❌ cargo: command not found 에러 → 설치 후 환경 변수가 적용되지 않은 상태예요. ✅ 터미널을 재시작하거나, $HOME/.cargo/bin 경로가 시스템 PATH에 등록되어 있는지 확인해 주세요.
• ❌ Cargo.toml 문법 에러 → 라이브러리 버전을 적을 때 오타가 났을 확률이 높아요. ✅ 대괄호 위치와 따옴표가 정확한지, 버전 번호 형식이 맞는지 다시 한번 체크해 보세요.
• ❌ Permission denied (권한 거부) → 시스템 폴더에 파일을 쓰려고 할 때 발생해요. ✅ 명령어 앞에 sudo를 붙이거나, 관리자 권한으로 터미널을 실행해 보세요.
• ❌ Rust 버전이 너무 낮다는 경고 → 오래된 툴체인을 사용 중이에요. ✅ rustup update 명령어를 입력하면 가장 최신 버전으로 즉시 업데이트할 수 있어요.

자주 묻는 질문

Q. Rust는 배우기 정말 어렵나요?

A. 솔직히 말씀드리면, 처음 접하는 개념(소유권, 빌림 등)이 생소해서 초반에는 조금 어렵게 느껴질 수 있어요. 하지만 환경 설정과 기본 문법을 익히고 나면, 컴파일러가 친절하게 에러를 설명해 주기 때문에 오히려 다른 언어보다 버그를 잡기가 훨씬 쉬워요.

Q. C++을 이미 알고 있는데 Rust를 배워야 할까요?
A. 네, 강력히 추천해요! C++의 성능은 유지하면서 메모리 안전성이라는 강력한 무기를 가질 수 있기 때문이에요. 현대적인 패키지 관리 시스템인 Cargo를 경험해 보면 개발 생산성 면에서도 큰 차이를 느끼실 거예요.

Q. Mac에서 M1/M2 칩을 사용 중인데 설치에 문제가 없나요?
A. 네, 전혀 문제없어요. rustup은 Apple Silicon 아키텍처를 완벽하게 지원하므로, 최적화된 바이너리를 자동으로 설치해 줍니다.

Q. Cargo와 rustc의 차이점이 정확히 무엇인가요?
A. rustc는 코드를 번역하는 ‘도구’ 그 자체이고, Cargo는 그 도구를 포함해 프로젝트 전체를 관리하는 ‘관리자’예요. 우리가 직접 rustc를 부르는 일은 드물고, 대부분 cargo에게 명령을 내려서 rustc가 작동하게 만들어요.

Q. 라이브러리를 어떻게 추가하나요?
A. Cargo.toml 파일의 [dependencies] 섹션에 원하는 라이브러리 이름을 추가하거나, 터미널에서 cargo add 라이브러리이름 명령어를 입력하면 자동으로 설치와 설정이 완료돼요.

성공적인 Rust 개발을 위한 마무리

지금까지 Rust 설치와 환경설정의 모든 과정을 살펴보았어요. 처음에는 낯선 명령어와 도구들이 많아 복잡해 보였겠지만, 이 환경만 잘 갖춰두면 여러분은 세상에서 가장 안전하고 빠른 언어 중 하나를 다룰 준비가 된 거예요. 이제 여러분의 코드가 멋지게 돌아가는 모습을 상상하며 다음 단계로 나아가 보세요.

환경 설정이 끝났다면 이제 무엇을 해야 할까요? 막막한 분들을 위해 간단한 로드맵을 제안해 드릴게요.

• 오늘 할 일: cargo new로 첫 프로젝트를 만들고 ‘Hello, world!’ 출력하기
• 이번 주 할 일: Rust의 핵심 개념인 ‘소유권(Ownership)’과 ‘빌림(Borrowing)’에 대해 가벼운 강의나 문서 읽어보기
• 실행 직전 할 일: 자주 사용하는 라이브러리(Crate)를 하나 골라 내 프로젝트에 직접 추가해 보기

지금 바로 터미널을 열고 Rust의 세계로 첫발을 내디뎌 보세요! 여러분의 도전을 진심으로 응원할게요. 지금 바로 Rust 설치와 환경설정을 예제와 함께 익혀 보세요!

함께 읽으면 좋은 글:
– 초보자를 위한 Rust 프로그래밍 입문 가이드
– Cargo를 활용한 효율적인 프로젝트 관리법