Установка Rust на Windows: подробное руководство

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

Rust — это современный системный язык программирования, обеспечивающий безопасность памяти и высокую производительность. Установка Rust на Windows открывает возможности для разработки системного ПО, встраиваемых систем, веб-серверов и даже игровых движков. Этот гайд поможет вам с нуля настроить среду разработки Rust на Windows 10 или 11, включая менеджер инструментов rustup, компилятор rustc и систему сборки cargo. После выполнения вы сможете компилировать и запускать Rust-программы локально.

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

Перед началом убедитесь, что:

• У вас установлена Windows 10 (версия 1809 или новее) или Windows 11.
• Есть подключение к интернету для загрузки инструментов (около 100 МБ).
• Вы имеете права на запись в папку %USERPROFILE% (обычно это C:\Users\ИмяПользователя).
• (Опционально) Для разработки под Windows с использованием WinAPI или сборки проектов с C-зависимостями рекомендуется установить Build Tools for Visual Studio (можно выбрать в установщике rustup или отдельно).

Шаг 1: Скачайте установщик rustup

rustup — это официальный менеджер инструментов Rust. Он управляет версиями компилятора, cargo и документации.

1. Откройте браузер и перейдите на официальную страницу rustup для Windows.
2. Нажмите кнопку «Download rustup-init.exe».
3. Сохраните файл в удобное место (например, в Загрузки).

Шаг 2: Запустите установку

1. Откройте PowerShell или Командную строку (CMD) от имени администратора (не обязательно, но рекомендуется для автоматического добавления в PATH).
2. Перейдите в папку, куда скачали файл, например:

   cd $env:USERPROFILE\Загрузки
   

3. Запустите установщик:

   .\rustup-init.exe
   

4. В текстовом интерфейсе установщика:
   • Нажмите Enter для продолжения.
   • Выберите опцию «1) Proceed with installation (default)».
   • Убедитесь, что выбрана опция «Add cargo to PATH» (добавить cargo в PATH). Это критически важно.
5. Дождитесь завершения установки. Rustup скачает последнюю стабильную версию Rust (компилятор rustc, cargo и документацию).

Шаг 3: Проверьте установку

После установки закройте и снова откройте терминал (PowerShell или CMD), чтобы изменения PATH вступили в силу.

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

rustc --version

Вывод должен быть примерно таким: rustc 1.78.0 (9b00959e5 2024-04-30) (версия может отличаться).

cargo --version

Вывод: cargo 1.78.0 (54d8815d0 2024-04-30).

Если команды не найдены, проверьте переменную PATH: должна присутствовать запись %USERPROFILE%\.cargo\bin.

Шаг 4: Создайте и запустите первый проект

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

   cargo new hello-rust
   

   
   Это создаст папку hello-rust с базовой структурой проекта.
2. Перейдите в папку проекта:

   cd hello-rust
   

3. Соберите и запустите проект:

   cargo run
   

   
   Вы увидите вывод Hello, world!. Это означает, что компилятор и сборщик работают корректно.

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

Успешная установка подтверждается:

• Команды rustc --version и cargo --version выводят версии без ошибок.
• Проект hello-rust успешно собирается и запускается, выводя Hello, world!.
• В папке %USERPROFILE%\.cargo\ присутствуют бинарные файлы rustc.exe, cargo.exe и другие.

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

Ошибка: rustc или cargo не распознаны как команды

Причина: Путь к %USERPROFILE%\.cargo\bin не добавлен в PATH или терминал не перезапущен. Решение:

1. Перезапустите терминал (или компьютер).
2. Проверьте PATH: в PowerShell выполните $env:Path и убедитесь, что там есть %USERPROFILE%\.cargo\bin.
3. Если нет, добавьте вручную:
   • Откройте «Системные свойства» → «Дополнительно» → «Переменные среды».
   • В разделе «Системные переменные» (или «Переменные среды пользователя») найдите Path, отредактируйте, добавьте новый элемент: %USERPROFILE%\.cargo\bin.
   • Перезапустите терминал.

Антивирус или защитник Windows блокирует установку

Причина: Некоторые антивирусы могут ложнно срабатывать на установочные скрипты. Решение: Временно отключите антивирус на время установки или добавьте исключение для папки %USERPROFILE%\.cargo\bin и скачиваемого rustup-init.exe.

Сборка падает с ошибками, связанными с link.exe или cl.exe

Причина: Для компиляции C-зависимостей требуются инструменты Visual Studio Build Tools. Решение: Установите Build Tools for Visual Studio (можно через установщик rustup: при запуске rustup есть опция установки компонентов) или вручную с официального сайта. В установщике выберите рабочую нагрузку «Разработка классических приложений на C++».

Rustup не может скачать компоненты из-за прокси

Причина: В корпоративной сети часто используется прокси-сервер. Решение: Настройте прокси для rustup через переменные среды HTTP_PROXY и HTTPS_PROXY. Например, в PowerShell:

$env:HTTP_PROXY="http://proxy.example.com:8080"
$env:HTTPS_PROXY="http://proxy.example.com:8080"

Затем перезапустите rustup: rustup self update или rustup toolchain install stable.