Язык программирования Rust

Установка

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

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

Следующие шаги установят последнюю стабильную версию компилятора Rust. Гарантии стабильности Rust обеспечивают, что все примеры из книги, которые компилируются, будут продолжать компилироваться и с более новыми версиями Rust.

Вывод может немного отличаться между версиями, потому что Rust часто улучшает сообщения об ошибках и предупреждения.

Иными словами, любая более новая стабильная версия Rust, установленная с помощью этих шагов, должна работать с материалом этой книги так, как ожидается.

Установка 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 в оставшейся части книги, чтобы использовать эти закешированные версии, а не пытаться обращаться к сети.