Установка

Первым делом установим Rust. Для этого мы используем rustup — приложение командной строки, позволяющее управлять версиями Rust и некоторыми другими основными инструментами. Вам понадобится подключение к интернету.

Примечание: Если по какой-то причине вы предпочитаете не использовать rustup, обратитесь к странице других методов установки Rust.

Следуя инструкции ниже, вы установите последнюю стабильную версию компилятора 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, а потому требуют его компилятор.

На macOS, вы можете установить компилятор C, выполнив эту команду:

$ xcode-select --install

Пользователям Linux, в общем случае, понадобится установить GCC или Clang — в соответствии с документацией конкретного дистрибутива. Например, если вы используете Ubuntu, то можете установить пакет build-essential.

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

Для установки на Windows перейдите на [https://www.rust-lang.org/tools/install] (https://www.rust-lang.org/tools/install) и выполните инструкцию по установке Rust. В какой-то момент установки, вам может понадобится установить Visual Studio. С ней вы получите компоновщик и библиотеки, необходимые для компиляции. Если на данном шаге вам нужна помощь, посетите [https://rust-lang.github.io/" "rustup/installation/windows-msvc.html](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 всё ещё не работает, есть несколько мест, где вам могут помочь. Вы можете найти площадки для общения с другими программистами на Rust на странице Сообщества.

Обновление и деинсталляция

Однажды установив Rust через rustup, вы можете легко его обновить. Откройте консоль и выполните следующую команду:

$ rustup update

Для удаления Rust и rustup запустите скрипт деинсталляции:

$ rustup self uninstall

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

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

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

Текстовые редакторы и интегрированные среды разработки (IDE)

Эта книга не подразумевает использование какого-либо конкретного инструмента для разбработки на Rust. Вам будет достаточно даже лишь любого текстового редактора! Тем не менее, многие текстовые редакторы и IDE (integrated development environment) имеют встроенную поддержку Rust. Вы можете список различных редакторов и IDE на странице инструментов разработки.