Skip to content

1.1. Installation

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

Note

rustup을 사용하지 않으려면 기타 러스트 설치 방법 페이지에서 더 많은 옵션을 참조하세요.

다음 단계에서는 최신 안정 버전의 Rust 컴파일러를 설치합니다. Rust의 안정성 보장은 이 책에서 컴파일하는 모든 예제가 최신 Rust 버전으로 계속 컴파일되도록 보장합니다. Rust는 종종 오류 메시지와 경고를 개선하기 때문에 출력은 버전마다 약간 다를 수 있습니다. 즉, 이 단계를 사용하여 설치하는 최신의 안정적인 Rust 버전은 이 책의 내용과 함께 예상대로 작동해야 합니다.

Command Line Notaion

이 장과 책 전체에서 터미널에서 사용되는 몇 가지 명령을 보여드리겠습니다. 터미널에 입력해야 하는 줄은 모두 $로 시작합니다. $ 문자는 각 명령의 시작을 나타내기 위해 표시되는 명령줄 프롬프트이므로 직접 입력할 필요는 없습니다. $로 시작하지 않는 줄은 일반적으로 이전 명령의 출력을 표시합니다. 또한 PowerShell 관련 예제에서는 $ 대신 >를 사용합니다.

Linux 또는 macOS에 rustup 설치하기

Linux 또는 macOS를 사용하는 경우 터미널을 열고 다음 명령을 입력합니다:

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

이 명령은 스크립트를 다운로드하고 Rust의 최신 안정 버전을 설치하는 rustup 도구의 설치를 시작합니다. 비밀번호를 입력하라는 메시지가 표시될 수 있습니다. 설치에 성공하면 다음 줄이 표시됩니다:

Rust is installed now. Great!

또한 Rust가 컴파일된 출력을 하나의 파일로 결합하는 데 사용하는 프로그램인 링커(Linker)가 필요합니다. 이미 가지고 있을 가능성이 높습니다. 링커 오류가 발생하면 일반적으로 링커가 포함된 C 컴파일러를 설치해야 합니다. 일부 일반적인 Rust 패키지는 C 코드에 의존하므로 C 컴파일러가 필요하기 때문에 C 컴파일러도 유용합니다.

macOS에서는 C 컴파일러를 실행하여 얻을 수 있습니다:

xcode-select --install

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

Windows에 rustup 설치하기

Windows의 경우 https://www.rust-lang.org/tools/install로 이동하여 Rust 설치 지침을 따릅니다. 설치 중 어느 시점에 Visual Studio 2013 이상용 MSVC 빌드 도구도 필요하다는 메시지가 표시됩니다.

빌드 도구를 사용하려면 Visual Studio 2022를 설치해야 합니다. 설치할 워크로드를 묻는 메시지가 표시되면 다음을 포함하세요:

  • "C++를 사용한 데스크톱 개발"
  • Windows 10 또는 11 SDK
  • 영어 언어 팩 구성 요소 및 선택한 다른 언어 팩

이 책의 나머지 부분에서는 cmd.exe와 PowerShell 모두에서 작동하는 명령을 사용합니다. 구체적인 차이점이 있는 경우 어느 쪽을 사용해야 하는지 설명합니다.

문제 해결

Rust가 올바르게 설치되었는지 확인하려면 셸을 열고 이 줄을 입력합니다:

rustc --version

릴리스된 최신 안정 버전의 버전 번호, 커밋 해시, 커밋 날짜가 다음 형식으로 표시되어야 합니다:

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

이 정보가 표시되면 Rust를 성공적으로 설치한 것입니다! 이 정보가 표시되지 않는다면 다음과 같이 %PATH% 시스템 변수에 Rust가 있는지 확인하세요.

Windows CMD에서

> echo %PATH%

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

> echo $env:Path

Linux 및 macOS에서는 다음을 사용합니다:

echo $PATH

이 방법이 모두 올바른데도 Rust가 여전히 작동하지 않는다면 여러 곳에서 도움을 받을 수 있습니다. 커뮤니티 페이지에서 다른 러스타시언과 연락하는 방법을 알아보세요.

업데이트 및 제거

rustup을 통해 Rust를 설치한 후에는 새로 출시된 버전으로 쉽게 업데이트할 수 있습니다. 셸에서 다음 업데이트 스크립트를 실행합니다:

rustup update

셸에서 다음 제거 스크립트를 실행하여 Rust 및 rustup을 제거합니다:

rustup self uninstall

로컬 문서

Rust 설치에는 오프라인에서 읽을 수 있도록 문서의 로컬 사본도 포함되어 있습니다. rustup doc를 실행하여 브라우저에서 로컬 문서를 엽니다.

표준 라이브러리에서 제공하는 타입이나 함수가 어떤 기능을 하는지, 어떻게 사용하는지 잘 모르겠다면 API(애플리케이션 프로그래밍 인터페이스) 설명서를 참조하세요!

References