Установка Rust на Debian: пошаговая инструкция через rustup

Введение / Зачем это нужно

Rust — это современный системный язык программирования, focused на производительность, безопасность памяти и параллелизм. Установка Rust на Debian (и производные, такие как Ubuntu) через официальный менеджер rustup является предпочтительным способом. Он даёт вам:

• Актуальные версии: Быстрый доступ к последним стабильным, бета- и ночным сборкам Rust.
• Управление версиями: Легко переключаться между разными версиями компилятора для разных проектов.
• Полный набор инструментов: Автоматическая установка cargo (менеджер пакетов и сборки), rustfmt (форматирование) и clippy (линтинг).

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

Требования / Подготовка

• Операционная система: Debian 10 (Buster) или новее, Ubuntu 18.04 или новее, или любой другой дистрибутив на базе Debian.
• Права доступа: Учетная запись с правами sudo для установки системных зависимостей.
• Соединение с интернетом: Для загрузки инструментов и компонентов.
• Терминал: Доступ к командной строке (bash, zsh и т.д.).

Пошаговая инструкция

Шаг 1: Обновление списка пакетов и установка зависимостей

Сначала убедимся, что система обновлена, и установим необходимые пакеты для сборки Rust из исходников (например, gcc, make).

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl build-essential

• curl потребуется для скачивания скрипта rustup.
• build-essential — это метапакет, который устанавливает gcc, make и другие инструменты для компиляции C-кода, необходимые Rust.

Шаг 2: Скачивание и запуск скрипта rustup

Запустите официальный установочный скрипт. Он спросит, хотите ли вы добавить rustup в PATH и обновить текущую оболочку.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

• Скрипт скачивает и запускает установку rustup в домашний каталог (~/.rustup).
• Он также устанавливает последнюю стабильную версию rustc (компилятор), cargo и документацию в ~/.cargo.

💡 Совет: Если вы хотите выполнить установку без интерактивных вопросов (например, в скрипте), используйте флаг -y: curl ... | sh -s -- -y.

Шаг 3: Настройка переменной окружения PATH

После успешной установки скрипт, скорее всего, предложит вам добавить ~/.cargo/bin в PATH. Если вы это пропустили или хотите сделать это вручную, выполните:

source $HOME/.cargo/env

Чтобы изменения сохранились автоматически при каждом запуске терминала, добавьте следующую строку в конец файла конфигурации вашей оболочки (например, ~/.bashrc, ~/.zshrc или ~/.profile):

export PATH="$HOME/.cargo/bin:$PATH"

После редактирования файла выполните source ~/.bashrc (или соответствующего файла) или просто откройте новое окно терминала.

Шаг 4: Проверка установки

Убедитесь, что все основные компоненты установлены и доступны:

rustc --version
cargo --version
rustup --version

Вывод должен выглядеть примерно так:

rustc 1.78.0 (9b00959e5 2024-04-30)
cargo 1.78.0 (54d8815d0 2024-04-30)
rustup 1.27.0 (6a2012a4a 2024-04-30)

Проверка результата

Создайте простой проект на Rust, чтобы убедиться, что всё работает end-to-end.

1. Создайте новый проект с помощью cargo:

   cargo new hello_world
   cd hello_world
   

2. Соберите проект:

   cargo build
   

   В каталоге target/debug/ должен появиться исполняемый файл hello_world.
3. Запустите проект:

   cargo run
   

   Вы должны увидеть вывод Hello, world!.

Если все команды выполнились без ошибок, установка прошла успешно.

Возможные проблемы

• rustc: command not found после установки. Это означает, что каталог ~/.cargo/bin не добавлен в PATH. Выполните source $HOME/.cargo/env или перезапустите терминал. Если проблема остаётся, проверьте, что вы добавили строку export PATH="$HOME/.cargo/bin:$PATH" в правильный файл конфигурации оболочки и перезагрузили его.
• Ошибки компиляции при установке rustup. Убедитесь, что установлен пакет build-essential (см. Шаг 1). Также проверьте наличие свободного места на диске (минимум ~1.5 ГБ).
• Проблемы с правами при записи в ~/.rustup. Убедитесь, что у вашего пользователя есть права на запись в домашний каталог. Не запускайте скрипт rustup с sudo — он предназначен для установки в домашний каталог текущего пользователя.
• Конфликт с системной версией Rust из репозитория Debian. Если вы ранее устанавливали rustc через apt, рекомендуется удалить её (sudo apt remove rustc cargo) чтобы избежать путаницы, так как rustup управляет своими собственными версиями изолированно.