Установка
Первым шагом является установка 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 всё равно не работает, есть несколько мест, где вы можете получить помощь. Узнайте, как связаться с другими разработчиками Rust (шуточное прозвище, которым мы себя называем) на странице сообщества сообщество.
Обновление и удаление
После установки Rust через rustup обновление до новой версии легко. В вашей оболочке запустите следующий скрипт обновления:
$ rustup update
Чтобы удалить Rust и rustup, запустите следующий скрипт удаления из вашей оболочки:
$ rustup self uninstall
Локальная документация
Установка Rust также включает локальную копию документации, чтобы вы могли читать её оффлайн. Запустите rustup doc, чтобы открыть локальную документацию в вашем браузере.
Всякий раз, когда тип или функция предоставляются стандартной библиотекой, и вы не уверены, что она делает или как её использовать, используйте документацию API, чтобы узнать об этом!
Текстовые редакторы и интегрированные среды разработки
В этой книге не делается предположений о том, какие инструменты вы используете для создания кода Rust. Практически любой текстовый редактор справится с задачей! Однако многие текстовые редакторы и интегрированные среды разработки (IDE) имеют встроенную поддержку Rust. Вы всегда можете найти довольно актуальный список многих редакторов и IDE на странице инструменты на веб-сайте Rust.
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/book/ch01-01-installation.html