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 и связанными инструментами. Для загрузки потребуется подключение к интернету.

Примечание: Если вы по какой-то причине не хотите использовать 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!

Вам также понадобится линкер — программа, которую 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. На одном из этапов установки вас попросят установить Visual Studio. Это предоставит линкер и нативные библиотеки, необходимые для компиляции программ. Если вам нужна дополнительная помощь на этом шаге, см. 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 всё равно не работает, есть несколько мест, где вы можете получить помощь. Узнайте, как связаться с другими Rustaceans (смешное прозвище, которым мы называем себя) на странице сообщества.

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

После установки Rust через rustup обновление до новой выпущенной версии просто. Из вашей оболочки выполните следующий скрипт обновления:

$ rustup update

Чтобы удалить Rust и rustup, выполните следующий скрипт удаления из вашей оболочки:

$ rustup self uninstall

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

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

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

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

Эта книга не делает предположений о том, какие инструменты вы используете для создания кода на Rust. Практически любой текстовый редактор справится с задачей! Однако многие текстовые редакторы и интегрированные среды разработки (IDE) имеют встроенную поддержку Rust. Вы всегда можете найти достаточно актуальный список многих редакторов и IDE на странице инструментов на сайте Rust.

Работа в автономном режиме с этой книгой

В нескольких примерах мы будем использовать пакеты Rust за пределами стандартной библиотеки. Чтобы работать с этими примерами, вам либо понадобится подключение к интернету, либо необходимо будет заранее загрузить эти зависимости. Чтобы загрузить зависимости заранее, вы можете выполнить следующие команды. (Мы подробно объясним, что такое cargo и что делает каждая из этих команд, позже.)

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

Это закэширует загрузки этих пакетов, так что вам не нужно будет загружать их позже. После выполнения этой команды вам не нужно сохранять папку get-dependencies. Если вы выполнили эту команду, вы можете использовать флаг --offline со всеми командами cargo в остальной части книги, чтобы использовать эти кэшированные версии вместо попыток использовать сеть.