Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Приложение E: Редакции

В главе 1 вы увидели, что cargo new добавляет немного метаданных в ваш файл Cargo.toml о издании. Это приложение рассказывает о том, что это значит!

Язык Rust и компилятор имеют шестинедельный цикл выпуска, что означает, что пользователи получают постоянный поток новых функций. Другие языки программирования выпускают более крупные изменения реже; Rust выпускает меньшие обновления чаще. Через некоторое время все эти крошечные изменения накапливаются. Но от выпуска к выпуску может быть трудно оглянуться назад и сказать: «Вау, между Rust 1.10 и Rust 1.31 Rust сильно изменился!»

Примерно каждые три года команда Rust выпускает новое издание Rust. Каждое издание объединяет функции, которые были реализованы, в чёткий пакет с полностью обновлённой документацией и инструментами. Новые издания поставляются как часть обычного шестинедельного процесса выпуска.

Издания служат разным целям для разных людей:

  • Для активных пользователей Rust новое издание объединяет инкрементальные изменения в понятный пакет.
  • Для не-пользователей новое издание сигнализирует, что были реализованы некоторые крупные достижения, что может заставить взглянуть на Rust снова.
  • Для тех, кто разрабатывает Rust, новое издание предоставляет объединяющую точку для проекта в целом.

На момент написания этой книги доступны четыре издания Rust: Rust 2015, Rust 2018, Rust 2021 и Rust 2024. Эта книга написана с использованием идиом издания Rust 2024.

Ключ edition в Cargo.toml указывает, какое издание компилятор должен использовать для вашего кода. Если ключ отсутствует, Rust использует 2015 в качестве значения издания по причинам обратной совместимости.

Каждый проект может выбрать издание, отличное от издания по умолчанию 2015. Издания могут содержать несовместимые изменения, такие как включение нового ключевого слова, которое конфликтует с идентификаторами в коде. Однако, если вы не выберете эти изменения, ваш код будет продолжать компилироваться даже при обновлении версии компилятора Rust, которую вы используете.

Все версии компилятора Rust поддерживают любое издание, которое существовало до выпуска этого компилятора, и они могут связывать крейты любых поддерживаемых изданий вместе. Изменения издания влияют только на то, как компилятор изначально анализирует код. Поэтому, если вы используете Rust 2015 и одна из ваших зависимостей использует Rust 2018, ваш проект будет компилироваться и сможет использовать эту зависимость. Обратная ситуация, когда ваш проект использует Rust 2018, а зависимость использует Rust 2015, также работает.

Чтобы было ясно: большинство функций будут доступны во всех изданиях. Разработчики, использующие любое издание Rust, будут продолжать видеть улучшения по мере выпуска новых стабильных версий. Однако в некоторых случаях, в основном при добавлении новых ключевых слов, некоторые новые функции могут быть доступны только в более поздних изданиях. Вам нужно будет переключить издания, если вы хотите воспользоваться такими функциями.

Для получения более подробной информации см. The Rust Edition Guide. Это полная книга, которая перечисляет различия между изданиями и объясняет, как автоматически обновить ваш код до нового издания с помощью cargo fix.