Установка

Первым шагом является установка Rust. Мы загрузим Rust, используя инструмент командной строки rustup, предназначенный для управлениями версиями Rust и другими связанными с ним инструментами. Вам понадобится интернет соединение для его загрузки.

Замечание: Если вы предпочтёте не использовать rustup по какой-то причине, пожалуйста, ознакомьтесь с другими вариантами на с странице the Rust installation page.

Следующие шаги устанавливают последнюю стабильную версию компилятора 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!

Дополнительно, вам нужен какой-то вариант программы "линковщика". Возможно какой-то у вас уже установлен, но если при попытке компиляции Rust программы вы получаете ошибки, что "линковщик" не смог выполнится, то это означает, что он не установлен в системе и вам необходимо установить его вручную. Компиляторы языка C обычно имеют в своём составе корректный линковщик. Поищите как установить на вашу платформу компилятор языка C. Также, некоторые общие Rust пакеты зависят от C кода и им тоже будет необходим компилятор C. Так что, имеет смысл его поставить сейчас.

Установка rustup на Windows

Для Windows, посетите ссылку https://www.rust-lang.org/tools/install и следуйте инструкциям для установки Rust. На некотором шаге установки вы можете получить сообщение, объясняющее необходимость инструментов сборки C++ для Visual Studio 2013 или более поздней версии. Самый простой способ получить их это инсталлировать Build Tools for Visual Studio 2019. Когда вас спросят, какие рабочие нагрузки установить, убедитесь, что выбраны "C++ build tools" и что включены Windows 10 SDK и компоненты пакета английского языка.

Остальные часть этой книги используют команды, работающие как в cmd.exe, так и в PowerShell. Есть некоторые отличия, которые мы объясним.

Обновление и удаление

После установки Rust с помощью rustup, обновление на последние версии выполняется с помощью следующего простого скрипта командой:

$ rustup update

Чтобы удалить Rust и rustup, выполните
следующую команду:

$ rustup self uninstall

Устранение возможных ошибок

Чтобы проверить, правильно ли у вас установлен Rust, откройте оболочку и введите эту строку:

$ rustc --version

Вы должны увидеть номер версии, хэш коммита и дату выпуска последней стабильной версии в следующем формате:

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

Если вы видите данную информацию, то вы установили всё успешно. Если нет и вы используете Windows, проверьте что путь к Rust находится в системной переменной %PATH%. Если он корректный, но Rust все ещё не работает, то есть множество мест, где можно получить помощь. Самое простое это канал #beginners официального Rust Discord сервера. Там можно списаться в другими пользователями Rust (Rustaceans - как мы себя называем) которые могут помочь. Другие хорошие ресурсы включают пользовательский форум и ресурс Stack Overflow.

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

Установка Rust также включает локальную копию документации, поэтому вы можете читать её в автономном режиме. Запустите rustup doc, чтобы открыть локальную документацию в вашем браузере.

Каждый раз, когда тип или функция предоставляется из стандартной библиотеки и вы не знаете, что они делают или как их использовать, используйте документацию по интерфейсу прикладного программирования (API), чтобы узнать это!