Rust 团队很高兴宣布 Rust 的新版本 1.70.0。Rust 是一种编程语言，使每个人都能构建可靠高效的软件。

如果您已通过 rustup 安装了先前版本的 Rust，则可以使用以下命令获取 1.70.0

$ rustup update stable

如果您还没有，您可以从我们网站上的相应页面获取 rustup，并在 GitHub 上查看1.70.0 的详细发布说明。

如果您想通过测试未来版本来帮助我们，您可以考虑更新本地以使用 beta 通道 (rustup default beta) 或 nightly 通道 (rustup default nightly)。请报告您遇到的任何错误！

1.70.0 稳定版中的新功能

crates.io 默认使用稀疏模式

Cargo 的“稀疏”协议现在默认启用，用于从 crates.io 读取索引。此功能之前已在Rust 1.68.0 中稳定化，但仍需要配置才能与 crates.io 一起使用。宣布的计划是在 1.70.0 中将其设为默认值，现在它来了！

从 crates.io 索引获取信息时，您应该会看到性能大幅提升。在限制性防火墙后面的用户需要确保可以访问 https://index.crates.io。如果您出于某种原因需要继续使用 GitHub 托管的 git 索引作为之前的默认值，则可以使用registries.crates-io.protocol 配置设置更改默认值。

需要注意的是，更改访问方法的一个副作用是，这也更改了 crate 缓存的路径，因此依赖项将被重新下载。一旦您完全决定使用稀疏协议，您可能需要清除旧的 $CARGO_HOME/registry/*/github.com-* 路径。

OnceCell 和 OnceLock

已稳定化两种用于一次性初始化共享数据的新类型，OnceCell 及其线程安全对应类型 OnceLock。这些可以在任何不需要立即构造的地方使用，甚至可能像全局变量中的非 const 数据那样不可能立即构造。

use std::sync::OnceLock;

static WINNER: OnceLock<&str> = OnceLock::new();

fn main() {
    let winner = std::thread::scope(|s| {
        s.spawn(|| WINNER.set("thread"));

        std::thread::yield_now(); // give them a chance...

        WINNER.get_or_init(|| "main")
    });

    println!("{winner} wins!");
}

像 lazy_static 和 once_cell 这样的 crate 在过去已经满足了这种需求，但现在这些构建块已成为标准库的一部分，从 once_cell 的 unsync 和 sync 模块移植而来。将来可能还会稳定化更多方法，以及存储其初始化函数的配套 LazyCell 和 LazyLock 类型，但这一步稳定化应该已经涵盖了许多用例。

IsTerminal

这个新稳定化的特征只有一个方法 is_terminal，用于确定给定的文件描述符或句柄是否代表一个终端或 TTY。这是对外部 crate（如 atty 和 is-terminal）中存在的函数进行标准化的另一种情况，使用的是 Unix 目标上的 C 库 isatty 函数以及其他地方的类似功能。一个常见的用例是程序区分在脚本中运行还是在交互模式下运行，例如在交互时呈现颜色甚至完整的 TUI。

use std::io::{stdout, IsTerminal};

fn main() {
    let use_color = stdout().is_terminal();
    // if so, add color codes to program output...
}

调试信息的命名级别

-Cdebuginfo 编译器选项之前只支持 0..=2 的数字，用于表示越来越多的调试信息，其中 Cargo 在 dev 和 test 配置文件中默认使用 2，在 release 和 bench 配置文件中默认使用 0。现在，这些调试级别可以通过名称设置：“none”（0）、“limited”（1）和“full”（2），以及两个新的级别，“line-directives-only” 和 “line-tables-only”。

Cargo 和 rustc 文档之前都将级别 1 称为“仅行表”，但它包含了所有函数的信息，只是没有类型和变量。现在该级别称为“limited”，而新的“line-tables-only”级别进一步减少到仅包含带有文件名和行号的回溯所需的最小信息。这最终可能会成为 -Cdebuginfo=1 使用的级别。另一个 line-directives-only 级别用于 NVPTX 分析，否则不建议使用。

请注意，这些命名选项目前还不能通过 Cargo.toml 使用。对该功能的支持将在下一个版本 1.71 中提供。

test CLI 中强制执行的稳定性

当编译 #[test] 函数时，可执行文件会从 test crate 获取命令行界面。此 CLI 有许多选项，包括一些尚未稳定化且需要指定 -Zunstable-options 的选项，就像 Rust 工具链中的许多其他命令一样。但是，虽然这仅在 nightly 版本中允许，但该限制在 test 中并不生效——直到现在。从 1.70.0 开始，Rust 的稳定版和 beta 版将不再允许不稳定的 test 选项，使其真正成为文档中所述的 nightly 版本专用选项。

已知在某些情况下，可能在没有用户直接知情的情况下使用了不稳定的选项，尤其是 IntelliJ Rust 和其他 IDE 插件中使用的 --format json。这些项目已经在调整以适应此更改，JSON 输出的状态可以在其跟踪问题 中跟踪。

稳定化的 API

• NonZero*::MIN/MAX
• BinaryHeap::retain
• std::collections::binary_heap::IntoIter 的默认值
• std::collections::btree_map::{IntoIter, Iter, IterMut} 的默认值
• std::collections::btree_map::{IntoKeys, Keys} 的默认值
• std::collections::btree_map::{IntoValues, Values} 的默认值
• std::collections::btree_map::Range 的默认值
• std::collections::btree_set::{IntoIter, Iter} 的默认值
• std::collections::btree_set::Range 的默认值
• std::collections::linked_list::{IntoIter, Iter, IterMut} 的默认值
• std::vec::IntoIter 的默认值
• std::iter::Chain 的默认值
• std::iter::Cloned 的默认值
• std::iter::Copied 的默认值
• std::iter::Enumerate 的默认值
• std::iter::Flatten 的默认值
• std::iter::Fuse 的默认值
• std::iter::Rev 的默认值
• std::slice::Iter 的默认值
• std::slice::IterMut 的默认值
• Rc::into_inner
• Arc::into_inner
• std::cell::OnceCell
• Option::is_some_and
• NonNull::slice_from_raw_parts
• Result::is_ok_and
• Result::is_err_and
• std::sync::atomic::Atomic*::as_ptr
• std::io::IsTerminal
• std::os::linux::net::SocketAddrExt
• std::os::unix::net::UnixDatagram::bind_addr
• std::os::unix::net::UnixDatagram::connect_addr
• std::os::unix::net::UnixDatagram::send_to_addr
• std::os::unix::net::UnixListener::bind_addr
• std::path::Path::as_mut_os_str
• std::sync::OnceLock

其他更改

查看Rust、Cargo 和Clippy 中的所有更改。

1.70.0 的贡献者

许多人共同创建了 Rust 1.70.0。没有你们，我们无法做到。 感谢！