러스트 설치

러스트를 처음 시작할 때 가장 많이 막히는 곳은 문법이 아니라 설치와 실행 환경입니다. 명령 하나가 어긋나 프로그램이 실행되지 않으면, 설치의 문제인데도 개념을 잘못 이해한 것으로 오해하기 쉽습니다. 이 글은 운영체제별로 러스트를 설치하고, 버전 확인을 넘어 실제로 프로그램 하나를 빌드하고 실행해 설치를 확인하는 데까지 진행합니다.

1장에서는 러스트를 설치하고, Hello, world! 프로그램을 작성해 직접 컴파일하며, 러스트의 빌드 도구이자 패키지 관리자인 Cargo로 프로젝트를 만든 뒤, 숫자 추리 게임을 만들어 봅니다. 아래 그림은 이 글에서 따라갈 설치 과정입니다.

러스트는 rustup이라는 명령줄 도구로 설치합니다. rustup은 러스트 컴파일러 rustc, Cargo, 표준 라이브러리를 묶은 툴체인(toolchain)을 설치하고, 새 버전으로 갱신하거나 여러 버전을 오가게 해 줍니다. 다만 컴파일한 결과를 실행 파일 하나로 묶는 링커(linker)와 운영체제의 네이티브 라이브러리는 설치하지 않으므로, 운영체제에 맞는 빌드 도구를 따로 갖춰야 합니다. 설치 중에 파일을 내려받으므로 인터넷에 연결되어 있어야 하며, 앞으로 쓸 터미널(PowerShell, cmd, bash, zsh 가운데 하나)을 미리 정해 두면 셸마다 다른 명령 표기 때문에 헷갈리는 일을 줄일 수 있습니다.

rustup 말고 다른 방법으로 설치하려면 기타 설치 방법을 참고합니다. 이 교재는 명령만 코드 블록에 적고, 그 명령의 출력은 따로 text 블록에 보여 줍니다.

Linux와 macOS에서 설치하기

터미널을 열고 다음 명령을 입력합니다. 최신 stable 러스트를 설치할 rustup 설치 스크립트를 내려받아 실행하며, 도중에 비밀번호를 물을 수 있습니다.

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

설치가 끝나면 다음 문장이 나타납니다. 설치 스크립트는 PATH 설정을 셸의 설정 파일에 더하므로, 지금 열린 터미널에서는 아직 rustc를 찾지 못할 수 있고 새로 연 터미널부터 쓸 수 있습니다.

Rust is installed now. Great!

링커는 대개 이미 설치되어 있지만, 컴파일할 때 링커를 실행할 수 없다는 오류가 나면 C 컴파일러를 설치합니다. C 컴파일러를 설치하면 보통 링커도 함께 설치되며, 자주 쓰이는 러스트 패키지 가운데 C 코드를 함께 컴파일하는 것도 있어서 어차피 필요할 때가 많습니다. macOS에서는 다음 명령으로 C 컴파일러를 설치합니다.

xcode-select --install

Linux에서는 배포판의 안내에 따라 GCC나 Clang을 설치하며, 예를 들어 Ubuntu에서는 build-essential 패키지를 설치합니다.

Windows에서 설치하기

Windows에서는 러스트 설치 페이지의 안내에 따라 설치 프로그램 rustup-init.exe를 내려받아 실행합니다. 이 교재는 Windows의 기본 대상인 MSVC 툴체인을 기준으로 하며, 이 툴체인은 Visual Studio의 링커와 Windows SDK를 씁니다. Visual Studio가 설치되어 있지 않으면 설치 프로그램이 Community 에디션을 함께 설치할지 물어 오므로, 그대로 진행하면 됩니다.

Visual Studio를 직접 설치한다면 rustup의 Windows 안내에 따라 C++를 사용한 데스크톱 개발(Desktop Development with C++) 워크로드를 고릅니다. 이 워크로드에 러스트가 쓰는 C++ 빌드 도구와 Windows SDK가 들어 있습니다. IDE 없이 Build Tools for Visual Studio만 설치할 수도 있지만, rustup 안내에 따르면 이때도 Visual Studio Community, Professional, Enterprise 가운데 한 에디션의 라이선스가 있어야 합니다. 영어 언어 팩을 함께 설치해 두면 오류 메시지를 영어로 볼 수 있어, 다른 사람에게 오류를 묻거나 검색할 때 편합니다.

앞으로 이 교재의 Windows 명령은 PowerShell을 기준으로 하며, cmd와 다른 곳은 따로 적습니다.

설치 확인하기

설치가 끝나면 열려 있던 터미널을 닫고 새 터미널을 연 뒤, 다음 두 명령을 실행합니다. 설치 프로그램이 PATH 환경 변수에 더한 러스트 도구 폴더는 새로 연 터미널부터 반영되기 때문입니다. PATH는 명령 이름만 입력했을 때 셸이 실행 파일을 찾아볼 폴더들을 적어 둔 환경 변수(environment variable)입니다.

rustc --version
cargo --version

두 명령이 모두 버전을 출력해야 합니다. rustc --version은 다음 형식으로 버전 번호, 그 버전을 만든 커밋의 해시(hash), 커밋 날짜를 보여 줍니다.

rustc x.y.z (abcabcabc yyyy-mm-dd)

버전이 출력된다는 것은 터미널이 두 도구를 찾았다는 뜻일 뿐, 링커까지 갖춰져 실행 파일을 만들 수 있다는 뜻은 아닙니다. 그래서 다음 명령으로 작은 프로젝트를 하나 만들고 실제로 빌드해 실행해 봅니다. cargo new와 cargo run은 Cargo 기초에서 자세히 설명합니다.

cargo new hello-rust
cd hello-rust
cargo run

Cargo가 빌드 과정을 몇 줄 출력한 뒤 마지막 줄에 Hello, world!가 나오면 설치가 끝난 것입니다.

버전이 출력되지 않는다면 PATH 환경 변수에 러스트가 설치된 폴더가 들어 있는지 확인합니다. rustup은 기본으로 사용자 홈 폴더의 .cargo/bin(Windows에서는 %USERPROFILE%\.cargo\bin)에 도구를 설치합니다. PowerShell에서는 첫 번째 명령으로, cmd에서는 두 번째 명령으로 PATH를 출력합니다.

echo $env:Path

echo %PATH%

Linux와 macOS에서는 다음 명령을 씁니다. 어느 셸이든 출력은 폴더 경로를 구분자로 이어 붙인 긴 한 줄이며, Windows는 세미콜론으로, Linux와 macOS는 콜론으로 경로를 나눕니다. 이 가운데 .cargo/bin(Windows에서는 .cargo\bin)으로 끝나는 경로가 없다면, 터미널을 새로 연 뒤 다시 확인합니다.

echo $PATH

그래도 해결되지 않으면 러스트 커뮤니티 페이지나 한국 러스트 사용자 그룹 디스코드에서 비슷한 사례를 찾아볼 수 있습니다. 러스트 사용자들은 스스로를 러스타시안(Rustacean)이라고 부릅니다.

업데이트와 삭제

rustup으로 설치했다면 다음 명령 하나로 툴체인을 최신 stable 버전으로 갱신합니다. 러스트는 6주마다 새 stable 버전을 내므로, 이 명령을 가끔 실행해 컴파일러와 Cargo, 표준 라이브러리를 함께 최신으로 맞춥니다. 갱신한 뒤에는 앞의 rustc --version으로 바뀐 버전을 확인할 수 있습니다.

rustup update

러스트와 rustup을 모두 지우려면 다음 명령을 씁니다. 툴체인 전체가 지워지므로, .cargo 폴더 안에 따로 둔 설정이 있다면 먼저 옮겨 둡니다.

rustup self uninstall

아래 표는 지금까지 나온 도구와 관리 명령이 각각 무엇을 맡는지, 그리고 성공했는지 무엇으로 확인하는지 정리한 것입니다.

설치에 문제가 있을 때는 rustc --version, cargo --version, cargo run을 차례로 실행해 어느 단계에서 실패하는지 봅니다. 앞의 두 명령이 실패하면 PATH나 툴체인 설치의 문제이고, 버전은 나오는데 cargo run이 링커를 찾지 못한다면 운영체제 빌드 도구의 문제입니다. 이렇게 실패한 단계를 먼저 가리면, 러스트 전체를 다시 설치하지 않고 필요한 부분만 고칠 수 있습니다.

로컬 문서

러스트를 설치하면 공식 문서의 사본도 함께 설치됩니다. rustup doc을 실행하면 브라우저에서 이 문서가 열리며, 인터넷에 연결되지 않아도 볼 수 있습니다. 표준 라이브러리의 타입이나 함수가 무엇을 하는지, 어떻게 쓰는지 모를 때 이 문서의 API(Application Programming Interface) 문서에서 찾아보면 됩니다.

정리

• 러스트는 rustup으로 설치하며, rustup은 rustc, Cargo, 표준 라이브러리를 묶은 툴체인을 관리합니다.
• 링커와 네이티브 라이브러리는 따로 필요하며, Linux와 macOS에서는 C 컴파일러를, Windows에서는 Visual Studio의 C++ 빌드 도구와 Windows SDK를 설치합니다.
• 설치는 rustc --version과 cargo --version의 출력에 더해, 작은 프로젝트의 cargo run이 Hello, world!를 출력할 때 끝납니다.
• 버전이 나오지 않으면 PATH를, 버전은 나오는데 링크에 실패하면 운영체제 빌드 도구를 확인합니다.
• rustup update로 갱신하고, rustup self uninstall로 지우며, rustup doc으로 로컬 문서를 엽니다.

연습 문제

1. 버전은 나오는데

rustc --version과 cargo --version은 모두 버전을 출력하는데, cargo run은 링커를 찾을 수 없다는 오류로 끝났습니다. 러스트 컴파일러가 없는 것일까요? 무엇부터 확인해야 하나요?

2. 방금 설치했는데

설치를 마친 터미널에서 바로 cargo --version을 입력했더니 명령을 찾을 수 없다고 나왔습니다. 무엇을 해 보아야 하나요?

다음 글 Hello, World!에서는 첫 러스트 프로그램을 작성하고, rustc로 직접 컴파일해 실행합니다.