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!

Вам также потребуется компоновщик (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. На каком-то этапе установки вам будет предложено установить 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), чтобы узнать!

Использование текстовых редакторов и IDE

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

Работа с этой книгой офлайн

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

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

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