附录 E - 版本说明

X 语言使用 editions（版本）系统来管理语言随时间的演变。版本允许 X 语言以向后兼容的方式发展，同时仍然引入新功能和改进。

在本附录中，我们将讨论 X 语言的 editions 系统、它们是什么、它们如何工作，以及每个 edition 中包含什么。

什么是 Editions？

edition 是 X 语言语言的一组功能的版本。新的 edition 可以引入不兼容的更改，例如：

但是，edition 与版本号不同。一个编译器可以支持多个 edition，你可以为每个包选择使用哪个 edition。

Editions 很重要有几个原因：

你在包的 x.toml 中指定 edition：

[package]
name = "my_package"
version = "0.1.0"
edition = "2024"

让我们看看假设的 X 语言 editions。

2024 edition 是 X 语言语言的第一个稳定 edition。

// 2024 edition 代码
function main() {
    let x = 5;
    println("x 是 {}", x);
}

未来的 editions 可能包括：

当新 edition 发布时，你可以按照自己的节奏过渡你的项目。

大多数时候，编译器可以帮助你检查与新 edition 的兼容性：

# 检查你的代码与新 edition 的兼容性
x fix --edition 2027

许多更改可以自动应用：

# 自动修复代码以使用新 edition
x fix --edition 2027

在新 edition 发布之前，你可以使用预览标志预览新功能：

[package]
name = "my_package"
edition = "2024"

[features]
preview = ["async_fn_traits", "let_chains"]

然后在你的代码中：

// 这启用预览功能
#![feature(async_fn_traits)]

async function example() {
    // ...
}

关于 editions 的一些最佳实践：

X 语言编译器支持多个 editions。你可以使用 --edition 标志为单个文件指定 edition：

# 使用特定 edition 编译
x compile --edition 2024 file.x

X 语言的 editions 系统：

Editions 是保持 X 语言语言现代化同时保持与现有代码兼容性的重要部分！