Встановлення

Наш перший крок - встановити Rust. Ми завантажимо Rust за допомогою rustup, інструмента командного рядка для керування виданнями Rust і пов'язаних інструментів. Для завантаження вам знадобиться з'єднання з Інтернетом.

Note: If you prefer not to use rustup for some reason, please see the Other Rust Installation Methods page for more options.

Наступні кроки встановлять найостаннішу стабільну версію компілятора Rust. Принципи стабільності Rust гарантують, що всі приклади в цій книжці, які можна скомпілювати, будуть компілюватися в новіших версіях Rust. Повідомлення можуть незначно змінюватися від версії до версії, бо Rust часто покращує повідомлення і попередження про помилки. Іншими словами, будь-яка новіша стабільна версія Rust, яку ви встановите за цією інструкцією, має працювати відповідно до змісту цієї книжки.

Запис у командному рядку

У цьому розділі та надалі в книжці ми використовуватимемо команди термінала. Рядки, що треба вводити в термінал, починаються з $. Не треба вводити сам символ $; це запрошення командного рядка, що лише позначає початок команди. Рядки, що не починаються з $ зазвичай показують те, що виводить попередня команда. Приклади, специфічні для PowerShell, будуть починатися на > замість $.

Встановлення rustup на Linux або macOs

Якщо ви користувач Linux або macOS, відкрийте термінал і введіть цю команду:

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

Ця команда завантажить сценарій і почне встановлення інструменту rustup, що встановить останню стабільну версію Rust. Можливо, у вас запитають ваш пароль. Якщо встановлення буде успішним, з'явиться цей рядок:

Rust is installed now. Great!

Крім того, вам знадобиться якийсь компонувальник (linker), тобто програма, яку Rust використовує, щоб об'єднати результати компіляції в один файл. Швидше за все, він уже встановлений. Якщо ви отримаєте повідомлення про помилки компонувальника, вам слід встановити компілятор C, який зазвичай включає компонувальник. Компілятор C також корисний, бо деякі поширені пакунки Rust залежать від коду на C і потребуватимуть компілятора C.

На macOS, ви можете отримати C компілятор, виконавши команду:

$ xcode-select --install

Користувачі Linux зазвичай мають встановлювати GCC або Clang, відповідно до документації свого дистрибутиву. Скажімо, якщо ви використовуєте Ubuntu, ви можете встановити пакунок build-essential.

Встановлення rustup на Windows

На Windows, перейдіть до https://www.rust-lang.org/tools/install і дотримуйтеся вказаних там інструкцій для встановлення Rust. У певний момент встановлення ви отримаєте повідомлення, що вам також знадобляться інструменти збірки MSVC для Visual Studio 2013 чи пізнішої. Щоб отримати інструменти збірки, вам потрібно встановити Visual Studio 2022. На питання, які робочі завантаження потрібно встановити, вкажіть:

  • “Desktop Development with C++”
  • SDK для Windows 10 чи 11
  • The English language pack component, along with any other language pack of your choosing

Надалі книжка використовує команди, які працюють як у cmd.exe, так і в PowerShell. Якщо будуть відмінності, ми пояснимо, що робити.

Вирішення проблем

To check whether you have Rust installed correctly, open a shell and enter this line:

$ rustc --version

You should see the version number, commit hash, and commit date for the latest stable version that has been released in the following format:

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

Якщо ви це бачите, Rust було успішно встановлено! Якщо ви не бачите цю інформацію, перевірте, чи є Rust у системній змінній %PATH%.

У Windows CMD наберіть:

> echo %PATH%

У PowerShell наберіть:

> echo $env:Path

У Linux і macOS наберіть:

echo $PATH

Якщо все правильно і Rust все ще не працює, можна звернутися по допомогу у кілька місць. Найпростіший - канал #beginners на офіційному каналі Discord Rust. Там ви можете спілкуватися з іншими растацеанцями (чудернацьке ім'я, як ми звемо себе), які можуть допомогти вам розібратися. Інші чудові ресурси включають користувацький форум і Stack Overflow.

Оновлення та видалення

Після встановлення Rust за допомогою rustup, коли виходить нова версія Rust, оновлення до останньої версії робиться легко. З командної оболонки запустіть такий сценарій оновлення:

$ rustup update

To uninstall Rust and rustup, run the following uninstall script from your shell:

$ rustup self uninstall

Локальна документація

Установлений Rust також включає локальну копію документації, тож ви можете читати її в офлайні. Запустіть rustup doc, щоб відкрити локальну документацію у веббраузері.

Any time a type or function is provided by the standard library and you’re not sure what it does or how to use it, use the application programming interface (API) documentation to find out!