Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

설치

첫 번째 단계는 Rust를 설치하는 것입니다. Rust 버전과 관련 도구를 관리하는 명령줄 도구인 rustup 을 통해 Rust를 내려받겠습니다. 다운로드하려면 인터넷 연결이 필요합니다.

Note: 어떤 이유로든 rustup 을 쓰고 싶지 않다면, 다른 Rust 설치 방법 페이지에서 추가 선택지를 확인하세요.

다음 단계는 Rust 컴파일러의 최신 안정 버전을 설치합니다. 러스트의 안정성 보장은 이 책에서 컴파일되는 모든 예제가 더 새로운 Rust 버전에서도 계속 컴파일되도록 보장합니다. 다만 Rust는 오류 메시지와 경고를 자주 개선하므로, 버전에 따라 출력이 조금 다를 수는 있습니다. 다시 말해, 여기 소개한 방법으로 설치한 더 새로운 안정 버전의 Rust라면 이 책의 내용과 함께 예상대로 동작해야 합니다.

명령줄 표기법

이 장과 책 전체에서 터미널에서 사용하는 몇 가지 명령을 보여 줄 것입니다. 터미널에 직접 입력해야 하는 줄은 모두 $ 로 시작합니다. $ 문자를 직접 입력할 필요는 없습니다. 각 명령의 시작을 나타내는 프롬프트일 뿐입니다. $로 시작하지 않는 줄은 보통 바로 앞 명령의 출력입니다. 또한 PowerShell 전용 예제에서는 $ 대신 > 를 사용합니다.

Linux 또는 macOS에 rustup 설치하기

Linux나 macOS를 사용한다면 터미널을 열고 다음 명령을 입력하세요.

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

이 명령은 스크립트를 내려받고 rustup 도구 설치를 시작합니다. rustup 은 Rust의 최신 안정 버전을 설치해 줍니다. 중간에 비밀번호 입력을 요구할 수 있습니다. 설치에 성공하면 다음 줄이 표시됩니다.

Rust is installed now. Great!

또한 linker 도 필요합니다. 이것은 Rust가 컴파일 결과물을 하나의 파일로 연결할 때 사용하는 프로그램입니다. 아마 이미 설치되어 있을 가능성이 큽니다. linker 관련 오류가 발생한다면 보통 linker를 포함하는 C 컴파일러를 설치해야 합니다. C 컴파일러는 일부 널리 쓰이는 Rust 패키지가 C 코드에 의존하기 때문에 그런 경우에도 유용합니다.

macOS에서는 다음 명령으로 C 컴파일러를 설치할 수 있습니다.

$ xcode-select --install

Linux 사용자는 일반적으로 사용하는 배포판의 문서에 따라 GCC나 Clang을 설치해야 합니다. 예를 들어 Ubuntu를 쓴다면 build-essential 패키지를 설치하면 됩니다.

Windows에 rustup 설치하기

Windows에서는 https://www.rust-lang.org/tools/install 으로 가서 Rust 설치 안내를 따르면 됩니다. 설치 과정 중 어느 시점에 Visual Studio를 설치하라는 안내가 나옵니다. 이것은 프로그램을 컴파일할 때 필요한 linker와 네이티브 라이브러리를 제공합니다. 이 단계에서 더 도움이 필요하다면 https://rust-lang.github.io/rustup/installation/windows-msvc.html를 참고하세요.

이 책의 나머지 부분에서는 cmd.exe 와 PowerShell 모두에서 동작하는 명령을 사용합니다. 둘 사이에 차이가 있는 경우에는 어느 쪽을 써야 하는지 따로 설명하겠습니다.

문제 해결

Rust가 제대로 설치되었는지 확인하려면 셸을 열고 다음 줄을 입력하세요.

$ rustc --version

다음과 같은 형식으로, 가장 최근에 릴리스된 안정 버전의 버전 번호, 커밋 해시, 커밋 날짜가 보여야 합니다.

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

이 정보가 보인다면 Rust 설치에 성공한 것입니다! 보이지 않는다면 아래와 같이 Rust가 %PATH% 시스템 변수에 들어 있는지 확인하세요.

Windows CMD에서는 다음을 사용합니다.

> echo %PATH%

PowerShell에서는 다음을 사용합니다.

> echo $env:Path

Linux와 macOS에서는 다음을 사용합니다.

$ echo $PATH

이 모든 것이 맞는데도 Rust가 동작하지 않는다면 도움을 받을 수 있는 곳이 여럿 있습니다. 다른 Rustacean(우리가 스스로를 부르는 다소 장난스러운 별명)과 어떻게 연락할 수 있는지는 커뮤니티 페이지에서 확인할 수 있습니다.

업데이트와 제거

rustup 으로 Rust를 설치했다면 새로 릴리스된 버전으로 업데이트하는 것은 쉽습니다. 셸에서 다음 업데이트 명령을 실행하세요.

$ rustup update

Rust와 rustup 을 제거하려면 셸에서 다음 제거 명령을 실행하세요.

$ rustup self uninstall

로컬 문서 읽기

Rust를 설치하면 문서의 로컬 사본도 함께 설치되므로 오프라인에서도 읽을 수 있습니다. rustup doc 명령을 실행하면 브라우저에서 로컬 문서가 열립니다.

표준 라이브러리가 제공하는 타입이나 함수가 무엇을 하는지, 어떻게 사용하는지 확실하지 않을 때는 언제든 API 문서를 찾아보세요!

텍스트 에디터와 IDE 사용하기

이 책은 여러분이 Rust 코드를 작성할 때 어떤 도구를 쓰는지에 대해 아무 가정도 하지 않습니다. 거의 모든 텍스트 에디터로 충분합니다! 다만 많은 텍스트 에디터와 통합 개발 환경(IDE)은 Rust를 기본적으로 지원합니다. Rust 웹사이트의 도구 페이지에서 다양한 에디터와 IDE의 비교적 최신 목록을 확인할 수 있습니다.

이 책을 오프라인으로 따라 하기

몇몇 예제에서는 표준 라이브러리 밖의 Rust 패키지를 사용합니다. 그런 예제를 따라 하려면 인터넷 연결이 있거나, 필요한 의존성을 미리 내려받아 두어야 합니다. 의존성을 미리 내려받으려면 다음 명령을 실행하면 됩니다. (cargo 가 무엇인지와 각 명령이 무엇을 하는지는 뒤에서 자세히 설명합니다.)

$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.8.5 trpl@0.2.0

이렇게 하면 해당 패키지 다운로드가 캐시에 저장되어 나중에 다시 내려받지 않아도 됩니다. 이 명령을 실행한 뒤에는 get-dependencies 폴더를 계속 보관할 필요는 없습니다. 이 과정을 마쳤다면, 책의 나머지 부분에서 사용하는 모든 cargo 명령에 --offline 플래그를 붙여 네트워크에 접근하려 하지 않고 캐시된 버전을 사용하도록 할 수 있습니다.