Введение / Зачем это нужно
Rust сочетает в себе высокую производительность системных языков и гарантии безопасности памяти на этапе компиляции. Создание первого проекта — это обязательный шаг, который познакомит вас с экосистемой rustup и пакетным менеджером Cargo. К концу этого руководства вы получите полностью рабочий исполняемый файл, научитесь управлять структурой каталогов и подготовите среду для дальнейшей разработки.
Требования / Подготовка
Перед началом убедитесь, что на вашем компьютере есть стабильный доступ в интернет и свободное место на диске (около 500 МБ для базового инструментария). Вам потребуется современный текстовый редактор (VS Code, Notepad++, Sublime Text или любой другой). Гайд универсален и корректно работает на Windows, macOS и Linux.
Пошаговая инструкция
Шаг 1: Установка Rust и Cargo
Официальный и самый безопасный способ установки — через rustup. Он автоматически загружает компилятор rustc, менеджер пакетов cargo и офлайн-документацию.
Для macOS и Linux выполните в терминале:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Для Windows скачайте исполняемый файл rustup-init.exe с официального сайта и запустите его. В процессе установки выберите стандартную конфигурацию (вариант 1).
💡 Совет: После завершения установки обязательно закройте текущее окно терминала и откройте новое. Это необходимо для корректного применения изменений в системной переменной
PATH.
Проверьте успешность установки, запросив версии инструментов:
rustc --version
cargo --version
Шаг 2: Создание структуры проекта
Перейдите в директорию, где планируете хранить свои учебные и рабочие проекты. В Rust проекты создаются одной командой:
cargo new my_first_project
cd my_first_project
Команда cargo new генерирует стандартную структуру:
Cargo.toml— манифест проекта. Здесь хранятся метаданные, версия компилятора и внешние зависимости.src/main.rs— главный исходный файл, с которого начинается исполнение программы.- Скрытая папка
.git— автоматически инициализированный репозиторий для контроля версий.
Шаг 3: Написание кода
Откройте файл src/main.rs в вашем редакторе. По умолчанию в нём уже находится базовый шаблон. Вы можете оставить его или заменить на собственный вариант:
fn main() {
println!("Привет, мир! Мой первый проект на Rust работает.");
}
Макрос println! выводит текст в консоль, а восклицательный знак указывает компилятору на то, что это именно макрос, а не обычная функция. Точка с запятой в конце строки обязательна.
Шаг 4: Компиляция и запуск
Вернитесь в корневую папку проекта и запустите выполнение:
cargo run
При первом запуске Cargo самостоятельно проверит наличие компилятора, скомпилирует ваш код в режиме отладки (debug) и сразу запустит полученный бинарник. Вы увидите системные сообщения о процессе сборки и вывод вашей программы.
Проверка результата
Убедитесь, что в терминале появились строки:
Compiling my_first_project v0.1.0 (/path/to/my_first_project)
Finished dev [unoptimized + debuginfo] target(s) in 1.24s
Running `target/debug/my_first_project`
Привет, мир! Мой первый проект на Rust работает.
Наличие строки Finished dev означает, что компиляция прошла успешно без ошибок и предупреждений. Исполняемый файл теперь лежит в папке target/debug/my_first_project (или .exe на Windows) и может запускаться напрямую без вызова cargo.
Возможные проблемы
Ошибка: cannot find binary path или command 'cargo' not found
Система не видит установленный инструмент. Добавьте путь ~/.cargo/bin (или %USERPROFILE%\.cargo\bin на Windows) в переменную окружения PATH вручную через настройки системы, либо выполните source $HOME/.cargo/env в текущей сессии терминала.
Ошибки компиляции при изменении кода Компилятор Rust очень строг к синтаксису и типизации. Если вы допустили опечатку, он укажет точный номер строки и характер проблемы. Внимательно читайте вывод терминала: красные блоки содержат описание ошибки и часто предлагают готовые исправления.
Предупреждения линтера (clippy)
Если вы видите жёлтые сообщения warning, это не остановит выполнение, но указывает на неидиоматичный код. Для автоматической проверки стиля запустите cargo clippy (предварительно установите компонент через rustup component add clippy) и примените предложенные оптимизации.