fn main() — бинарный crate и библиотека Rust
В Rust fn main() — точка входа исполняемого crate. Библиотека ([lib] в Cargo.toml) публикует функции и типы; main в ней не запускается при use mycrate::….
См. также: Первая программа · Cargo workspace · Python — аналог.
Бинарный crate по умолчанию
cargo new myapp создаёт:
// src/main.rs
fn main() {
println!("Hello, world!");
}
cargo run
Компилятор собирает бинарник и передаёт управление в main.
Библиотека + отдельный binary
cargo new --lib mylib создаёт src/lib.rs:
pub fn add(a: i32, b: i32) -> i32 {
a + b
}
Точка входа для демо — второй target или файл src/main.rs в том же проекте:
# Cargo.toml
[lib]
name = "mylib"
path = "src/lib.rs"
[[bin]]
name = "mylib-demo"
path = "src/main.rs"
// src/main.rs
fn main() {
println!("{}", mylib::add(5, 3));
}
| Команда | Что происходит |
|---|---|
cargo run | Запуск default binary (main.rs) |
use mylib::add из другого crate | Только API из lib.rs, без main |
examples/ и tests
Для библиотек демо часто кладут в examples/demo.rs:
cargo run --example demo
Юнит-тесты — в #[cfg(test)] mod tests внутри lib.rs; они не попадают в release-сборку.
Это замена Python-паттерну "демо в if __name__ == "__main__" в том же файле".
main с Result
fn main() -> Result<(), Box<dyn std::error::Error>> {
let config = load_config()?;
run_server(config)?;
Ok(())
}
Ошибки из ? в main с такой сигнатурой превращаются в код выхода процесса.
Сравнение с Python
| Python | Rust |
|---|---|
Один .py — модуль и скрипт | lib.rs и main.rs / [[bin]] |
if __name__ == "__main__": | Отдельный binary target или examples/ |
| Import выполняет top-level код | use только подтягивает items; main чужого crate не вызывается |
Дальше по разделу
| Тема | Статья |
|---|---|
| cargo new, первая сборка | Первая программа на Rust — Первая программа |
| Модули | Синтаксис и пунктуация в Rust — Синтаксис |
| Тесты | Тестирование в Rust — Тестирование |
Расширение темы
Что важно понимать на практике
Тема main и структура crate в Rust редко ограничивается только определением и одним примером. В реальной работе важно понимать контекст: зачем это нужно бизнесу, какие есть ограничения, и как решение ведет себя при росте нагрузки. Полезный ориентир: любой новый термин должен быть привязан к конкретному сценарию, где он приносит измеримую пользу.
Рабочий подход для новичка
- Сначала собрать минимальный рабочий пример.
- Затем усложнить его: добавить негативный сценарий и обработку ошибок.
- После этого проверить читаемость и поддержку: понятные имена, единый стиль, комментарии только там, где без них трудно.
- В конце — зафиксировать выводы и правила, чтобы команда использовала один подход.
Типичные ошибки
- Слишком ранняя оптимизация до понимания базового сценария.
- Смешение нескольких задач в одном большом модуле.
- Отсутствие критериев качества, из-за чего решение сложно проверить.
- Копирование кода без объяснения, почему выбран именно этот путь.
Мини-практика
Возьмите небольшой фрагмент по теме main и структура crate в Rust и улучшите его в три шага: сначала сделайте рабочим, затем устойчивым к ошибкам, затем удобным для чтения другим разработчиком. Так формируется инженерное мышление: также "чтобы запускалось", но и "чтобы поддерживалось".
Как проверять качество результата
- Понимает ли другой человек решение без устных пояснений.
- Есть ли пример входных данных и ожидаемый результат.
- Очевидно ли, где расширять решение дальше.
- Не нарушен ли единый стиль раздела и терминов.
Если эти пункты выполняются, материал становится полезным также для знакомства с темой, но и для ежедневной практики.
Дополнительный пример
Контекст -> Решение -> Проверка -> Выводы
Такой шаблон можно применять почти к любой инженерной задаче: он помогает не терять логику и быстрее объяснять решение команде.
Углубление и сценарии применения
Сценарий 1 базовый
Сначала фиксируйте самый простой рабочий сценарий, где тема приносит понятный результат. Затем добавляйте проверку входных данных и явную обработку ошибок. Такой порядок помогает избежать хрупкой архитектуры.
Сценарий 2 командная разработка
Когда с материалом работает несколько человек, договоритесь о единых соглашениях: структура файлов, правила именования, формат примеров и критерии готовности. Это уменьшает число конфликтов и ускоряет ревью.
Сценарий 3 масштабирование
При росте проекта полезно заранее определить границы модулей, точки расширения и ответственность между слоями. Даже простая диаграмма зависимостей помогает увидеть узкие места до того, как они станут проблемой в продакшене.
Антипаттерны
- Монолитный модуль без разделения ответственности.
- Отсутствие тестовых примеров и проверяемых критериев результата.
- Скрытые зависимости, о которых знает только автор.
- Документация, которая не совпадает с текущей реализацией.
Что добавить в личный конспект
- Короткое определение термина своими словами.
- Один рабочий пример с ожидаемым результатом.
- Два частых сбоя и способ их предотвращения.
- Мини-шпаргалку по проверке качества перед публикацией.
Так материал превращается из "прочитал и забыл" в инструмент, который можно использовать в работе и обучении.
Углубление и сценарии применения
Сценарий 1 базовый
Сначала фиксируйте самый простой рабочий сценарий, где тема приносит понятный результат. Затем добавляйте проверку входных данных и явную обработку ошибок. Такой порядок помогает избежать хрупкой архитектуры.
Сценарий 2 командная разработка
Когда с материалом работает несколько человек, договоритесь о единых соглашениях: структура файлов, правила именования, формат примеров и критерии готовности. Это уменьшает число конфликтов и ускоряет ревью.
Сценарий 3 масштабирование
При росте проекта полезно заранее определить границы модулей, точки расширения и ответственность между слоями. Даже простая диаграмма зависимостей помогает увидеть узкие места до того, как они станут проблемой в продакшене.
Антипаттерны
- Монолитный модуль без разделения ответственности.
- Отсутствие тестовых примеров и проверяемых критериев результата.
- Скрытые зависимости, о которых знает только автор.
- Документация, которая не совпадает с текущей реализацией.
Что добавить в личный конспект
- Короткое определение термина своими словами.
- Один рабочий пример с ожидаемым результатом.
- Два частых сбоя и способ их предотвращения.
- Мини-шпаргалку по проверке качества перед публикацией.
Так материал превращается из "прочитал и забыл" в инструмент, который можно использовать в работе и обучении.
Углубление и сценарии применения
Сценарий 1 базовый
Сначала фиксируйте самый простой рабочий сценарий, где тема приносит понятный результат. Затем добавляйте проверку входных данных и явную обработку ошибок. Такой порядок помогает избежать хрупкой архитектуры.
Сценарий 2 командная разработка
Когда с материалом работает несколько человек, договоритесь о единых соглашениях: структура файлов, правила именования, формат примеров и критерии готовности. Это уменьшает число конфликтов и ускоряет ревью.
Сценарий 3 масштабирование
При росте проекта полезно заранее определить границы модулей, точки расширения и ответственность между слоями. Даже простая диаграмма зависимостей помогает увидеть узкие места до того, как они станут проблемой в продакшене.
Антипаттерны
- Монолитный модуль без разделения ответственности.
- Отсутствие тестовых примеров и проверяемых критериев результата.
- Скрытые зависимости, о которых знает только автор.
- Документация, которая не совпадает с текущей реализацией.
Что добавить в личный конспект
- Короткое определение термина своими словами.
- Один рабочий пример с ожидаемым результатом.
- Два частых сбоя и способ их предотвращения.
- Мини-шпаргалку по проверке качества перед публикацией.
Так материал превращается из "прочитал и забыл" в инструмент, который можно использовать в работе и обучении.
Термины простыми словами
- SLA — согласованный срок реакции и решения по обращению.
- Инцидент — сбой, который нарушает работу сервиса.
- Мастер-данные — ключевые справочники, общие для разных процессов.
- TCO — полная стоимость владения решением за выбранный период.