[IT-방법] Rust 설치와 환경설정 빠른 시작 – 초보 개발자를 위한 10분 완성 가이드

왜 지금 Rust를 배워야 할까요?

새로운 프로그래밍 언어를 배우려고 마음먹었을 때 가장 큰 벽은 무엇인가요? 사실 코드를 한 줄도 쓰기 전, 환경 설정 단계에서 이미 진이 빠지는 경우가 정말 많아요. 설치 명령어 하나를 입력했는데 알 수 없는 에러 메시지가 뜨거나, 환경 변수가 꼬여서 명령어가 인식되지 않을 때의 그 막막함은 모든 개발자가 한 번쯤 겪어본 일이에요.

특히 Rust는 성능과 안정성을 동시에 잡은 강력한 언어지만, 그만큼 컴파일러가 엄격해서 초기 설정이 제대로 되지 않으면 시작조차 하기 힘들어요. 하지만 걱정하지 마세요. 이 글을 끝까지 따라오신다면 복잡한 문서들을 뒤지는 대신, 딱 10분 만에 여러분의 컴퓨터를 Rust 개발이 가능한 상태로 만들 수 있어요.

지금 Rust를 배우는 것은 아주 탁월한 선택이에요. 메모리 안전성을 보장하면서도 C++에 버금가는 속도를 내는 이 언어는 현대 시스템 프로그래밍의 표준으로 자리 잡고 있어요. 구글이나 아마존 같은 글로벌 기업들이 왜 앞다투어 Rust를 도입하는지 직접 코드를 짜며 체감해 보셨으면 좋겠어요.

이 가이드를 통해 여러분은 다음과 같은 것들을 얻어갈 수 있어요.

• 운영체제별 최적화된 Rust 설치 방법
• 개발 효율을 극대화하는 필수 도구 세팅
• 프로젝트를 생성하고 첫 코드를 실행하는 과정
• 설치 과정에서 흔히 발생하는 오류 해결법

자, 이제 막막한 준비 과정은 끝내고 본격적으로 Rust의 세계로 뛰어들어 볼까요?

설치 전 꼭 확인해야 할 준비물과 체크리스트

무작정 설치 버튼을 누르기 전에, 현재 여러분의 컴퓨터 상태를 점검하는 과정이 필요해요. 준비 없이 시작했다가 컴파일러가 요구하는 기본 라이브러리가 없어서 당황하는 상황을 방지하기 위해서예요.

가장 먼저 확인해야 할 것은 사용 중인 운영체제(OS)의 종류예요. Windows, macOS, Linux는 각각 Rust를 설치하는 방식과 추가로 요구하는 도구가 조금씩 다르거든요. 또한, 터미널(Terminal)이나 명령 프롬프트(CMD)를 사용하는 것에 거부감이 없어야 해요. Rust는 마우스 클릭보다는 텍스트 명령어를 통해 소통하는 언어니까요.

운영체제별로 어떤 환경을 준비해야 하는지 아래 표로 정리해 두었으니, 본인의 환경에 맞춰 미리 체크해 보세요.

특히 Windows 사용자라면 주의할 점이 있어요. Rust는 내부적으로 C++ 컴파일러를 사용하여 코드를 빌드하기 때문에, Visual Studio의 C++ 빌드 도구가 반드시 설치되어 있어야 해요. 이게 없으면 설치는 성공해도 나중에 코드를 실행할 때 계속해서 에러가 발생할 거예요.

반면 macOS 사용자라면 터미널을 열고 xcode-select --install 명령어를 미리 실행해 두는 것이 좋아요. Linux 사용자는 대부분의 배포판에서 개발 도구가 잘 갖춰져 있지만, 만약을 위해 build-essential 같은 패키지를 미리 설치해 두면 훨씬 매끄럽게 진행할 수 있어요.

실전! Rust 설치부터 첫 프로젝트 실행까지

이제 모든 준비가 끝났다면 실제로 Rust를 설치하고 작동시켜 볼 시간이에요. 이 과정은 크게 다섯 단계로 나눌 수 있어요. 차근차근 따라오시면 됩니다.

STEP 1. Rustup으로 공식 설치 도구 실행하기

Rust를 설치하는 가장 표준적이고 권장되는 방법은 rustup이라는 도구를 사용하는 거예요. rustup은 Rust의 버전들을 관리하고, 컴파일러와 관련 도구들을 손쉽게 업데이트할 수 있게 도와주는 아주 똑똑한 도구예요.

먼저 공식 사이트에 접속하거나 터미널을 열어 명령어를 입력해야 해요. macOS나 Linux 사용자는 터미널에 아래 명령어를 복사해서 붙여넣으세요.

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

이 명령어를 실행하면 설치 스크립트가 내려받아지면서 설치 옵션을 물어볼 거예요. 대부분의 경우 1번(default installation)을 선택하고 엔터를 누르면 가장 최적화된 설정으로 설치가 진행돼요. 설치가 완료되었다면, 변경된 환경 변수를 적용하기 위해 터미널을 완전히 껐다가 다시 켜거나 source $HOME/.cargo/env 명령어를 입력해 주세요.

STEP 2. 운영체제별 맞춤형 마무리 작업

설치 스크립트가 성공적으로 끝났더라도, 앞서 말씀드린 대로 운영체제마다 추가적인 작업이 필요할 수 있어요. 설치 후 rustc --version 명령어를 입력했을 때 버전 정보가 잘 나온다면 기본 설치는 성공한 거예요.

하지만 만약 빌드 도구가 없다는 에러가 뜬다면 아래 내용을 확인해 보세요.

• Windows: Visual Studio Installer를 실행하여 ‘C++를 사용한 데스크톱 개발’ 워크로드가 체크되어 있는지 반드시 확인해야 해요.
• macOS: 터미널에서 xcode-select --install을 입력하여 도구를 설치해 주세요.
• Linux: Ubuntu 기준으로 sudo apt update && sudo apt install build-essential 명령어를 통해 빌드 도구를 갖춰야 해요.

STEP 3. 최고의 개발 환경, VS Code 설정하기

검은 화면의 터미널만 보고 코딩할 수는 없겠죠? 가장 많은 개발자가 사용하고 Rust와 궁합이 잘 맞는 Visual Studio Code(VS Code)를 추천해요. VS Code를 설치했다면, 이제 Rust 개발을 훨씬 편하게 만들어줄 확장을 설치해야 해요.

VS Code의 Extensions(확장) 마켓플레이스에서 rust-analyzer를 검색해서 설치해 주세요. 예전에는 ‘Rust’라는 이름의 확장이 있었지만, 지금은 rust-analyzer가 훨씬 빠르고 강력한 기능을 제공해요. 이 확장을 설치하면 코드를 작성할 때 실시간으로 에러를 잡아주고, 자동 완성 기능도 제공하며, 타입 정보를 바로 확인할 수 있어 학습 속도가 비약적으로 빨라져요.

STEP 4. Cargo를 이용한 프로젝트 생성과 관리

Rust의 진정한 마법은 Cargo라는 도구에서 시작돼요. Cargo는 Rust의 빌드 시스템이자 패키지 관리자예요. 새로운 프로젝트를 만들고, 외부 라이브러리를 가져오고, 코드를 빌드하는 모든 과정을 Cargo가 대신 해준답니다.

이제 터미널을 열고 프로젝트를 만들고 싶은 폴더로 이동한 뒤, 아래 명령어를 입력해 보세요.

cargo new hello_rust

명령어를 실행하면 hello_rust라는 폴더가 생기고, 그 안에 자동으로 프로젝트 구조가 만들어져요. 폴더 안을 살펴보면 다음과 같은 구조를 볼 수 있을 거예요.

• Cargo.toml: 프로젝트의 이름, 버전, 그리고 사용할 외부 라이브러리(dependencies)를 기록하는 설계도 같은 파일이에요.
• src/main.rs: 실제로 여러분이 코드를 작성할 핵심 파일이에요.
• .gitignore: Git을 사용한다면 불필요한 빌드 파일이 업로드되지 않도록 도와주는 설정 파일이에요.

직접 폴더를 하나씩 만들어가는 수고를 덜어주니 정말 편리하죠?

STEP 5. 첫 번째 코드 실행: Hello, Rust!

이제 모든 준비가 끝났으니, 실제로 코드가 돌아가는지 확인해 볼 시간이에요. 방금 만든 폴더로 이동해 보세요.

cd hello_rust

그다음, 아래 명령어를 입력하면 Cargo가 코드를 컴파일하고 실행까지 한 번에 완료해 줘요.

cargo run

잠시 기다리면 터미널에 Hello, world!라는 문구가 나타날 거예요. 이 문구를 보셨다면 여러분은 이제 공식적으로 Rust 개발자가 된 거예요! 축하드립니다!

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

설치 과정이 매끄럽지 않다면 대부분 아래의 몇 가지 상황 중 하나일 확률이 높아요. 당황하지 말고 하나씩 체크해 보세요.

자주 하는 실수와 해결법

❌ ‘cargo’ 또는 ‘rustc’ 명령어를 찾을 수 없다고 나와요.
왜 발생하는가: 설치는 되었지만, 컴퓨터가 이 명령어들이 어디 있는지 모르는 상태(PATH 미설정)예요.
✅ 해결법: 터미널을 완전히 종료했다가 다시 실행해 보세요. 그래도 안 된다면 source $HOME/.cargo/env 명령어를 입력하여 환경 변수를 수동으로 불러와야 해요.

❌ Windows에서 빌드 시 ‘linker’ 관련 에러가 떠요.
왜 발생하는가: C++ 빌드 도구가 설치되지 않았거나, 설치 과정에서 누락된 구성 요소가 있기 때문이에요.
✅ 해결법: Visual Studio Installer를 다시 열어 ‘C++를 사용한 데스크톱 개발’ 항목이 제대로 설치되어 있는지 꼭 확인해 주세요.

❌ rust-analyzer가 작동하지 않아요.
왜 발생하는가: VS Code의 확장 프로그램이 설치되지 않았거나, 프로젝트 폴더를 직접 열지 않았기 때문이에요.
✅ 해결법: VS Code에서 File > Open Folder를 통해 Cargo.toml 파일이 있는 프로젝트 루트 폴더를 정확히 열어야 해요.

❌ 설치 스크립트 실행 중 권한 에러가 발생해요.
왜 발생하는가: 시스템 폴더에 접근할 권한이 부족하기 때문이에요.
✅ 해결법: macOS나 Linux라면 명령어 앞에 sudo를 붙이는 대신, 사용자 홈 디렉토리에 설치되도록 권장되는 기본 스크립트 방식을 그대로 사용해 보세요.

❌ 컴파일 속도가 너무 느려요.
왜 발생하는가: 첫 빌드 시에는 모든 의존성을 다운로드하고 컴파일해야 하므로 시간이 걸려요.
✅ 해결법: 처음 한 번만 견디면 됩니다. 이후에는 변경된 부분만 빌드하는 증분 빌드(Incremental Build)가 작동하여 훨씬 빨라져요.

자주 묻는 질문

Q. Rust는 배우기 아주 어려운 언어인가요?

A. 솔직히 말씀드리면, 초기 개념인 ‘소유권(Ownership)’을 이해하는 데 약간의 시간이 필요해요. 하지만 이 개념은 코드를 짜는 도중에 발생할 수 있는 치명적인 버그를 컴파일 단계에서 미리 잡아주기 때문에, 결과적으로는 훨씬 안전하고 편하게 코딩할 수 있게 도와준답니다.

Q. IntelliJ나 다른 IDE를 사용해도 되나요?
당연히 가능해요! IntelliJ IDEA나 CLion 같은 JetBrains 제품군에서도 Rust 플러그인을 통해 훌륭한 개발 환경을 제공해요. 다만 입문자에게는 가볍고 설정이 쉬운 VS Code를 가장 추천해요.

Q. Rust를 배우면 어떤 일을 할 수 있나요?
A. 웹 어셈블리(Wasm)를 이용한 웹 프론트엔드 개발, 고성능 서버 백엔드, 운영체제 커널 개발, 게임 엔진 제작 등 시스템의 밑바닥부터 최상단까지 거의 모든 분야에 활용할 수 있어요.

Q. 업데이트는 어떻게 하나요?
A. 매우 간단해요! 터미널에 rustup update라고 입력하기만 하면 모든 도구가 최신 버전으로 업데이트돼요.

Q. Mac M1/M2 칩에서도 잘 작동하나요?
A. 네, 아주 잘 작동해요. Apple Silicon에 최적화된 아키텍처를 완벽하게 지원하므로 걱정 없이 사용하셔도 돼요.

성공적인 Rust 학습을 위한 마무리

지금까지 Rust 설치와 환경설정 과정을 빠르게 살펴보았어요. 처음에는 낯선 명령어와 엄격한 컴파일러 때문에 조금 당황스러울 수도 있지만, 이 과정은 여러분이 더 단단하고 안전한 소프트웨어를 만드는 개발자로 성장하기 위한 필수적인 통과 의례와 같아요.

이제 환경 설정은 끝났으니, 다음 단계로 나아갈 차례예요. 무작정 두꺼운 책을 보기보다는 작은 실습부터 시작하는 것을 추천드려요.

🚀 오늘 바로 할 일: 터미널을 열고 cargo new로 프로젝트를 만든 뒤, Hello World를 출력해 보세요.
📅 이번 주 목표: Rust 공식 문서인 ‘The Book’의 1~3장을 읽으며 소유권 개념을 가볍게 훑어보세요.
🛠 실행 직전 팁: 코드가 막힐 때는 에러 메시지를 그대로 복사해서 구글이나 ChatGPT에 물어보는 습관을 들이세요. 에러 메시지 안에 정답이 거의 다 들어있거든요.

딱 10분, Rust 설치와 환경설정을 지금 바로 시작해 보세요! 여러분의 코드가 더 안전하고 빨라지는 놀라운 경험이 기다리고 있어요.

관련된 다른 글도 확인해 보세요: Rust 프로그래밍 입문 가이드, 효율적인 개발을 위한 VS Code 플러그인 추천