Rust 1.99.1 发布后的 i686 std-only 迁移影响

Rust 1.99.1 发布后，真正需要先确认的不是“要不要立刻改代码”，而是项目把 i686 当成运行目标，还是把 i686 当成构建主机。Rust 官方说明，1.99.1 是修复 wcslen 缺失、x86_64 FFI bool 返回值误编译和 macOS rust-lld 加载问题的修复版本；i686 Windows 的变化则是后续 Rust 1.100 之后逐步落地的支持策略调整。

官方资料：https://blog.rust-lang.org/2026/10/02/demoting-i686-windows-targets-to-std-only/

迁移结论可以先记成一句话：i686 Windows 仍然可以作为产物目标使用 std，但不要再把 32 位 Windows 当作长期运行 rustc、Cargo 和完整工具链的主机；把构建工作移到受支持的 64 位主机，再安装 i686 目标标准库和所需链接器。

先把 1.99.1 与 std-only 时间点分开

发布说明里的 1.99.1 重点是修复回归，不是宣布 i686 Windows 已经在这一个版本停止提供编译器。Rust 官方博客写明，i686-pc-windows-msvc 与 i686-pc-windows-gnu 的 host tools 调整安排在 Rust 1.100 之后；预编译标准库仍会继续分发，目标二进制仍然可以从受支持的主机交叉编译。

因此，现有项目第一步应记录两个独立字段：当前稳定工具链版本，以及构建主机与目标三元组。只看到 rustc --version 是 1.99.1，并不能推出 i686 产物不可构建；同样，能下载 rust-std 也不代表可以在 32 位 Windows 主机上继续安装完整 host toolchain。

真正受影响的是哪一种构建方式

把场景分成两类，迁移判断会清楚很多：

不要把“目标能运行”与“主机能开发”混成一个结论。std-only 的含义是目标的标准库继续存在，但目标不再承担 host tools 的角色。项目如果只是发布 32 位 Windows 二进制，通常只需要重构构建机；如果仍依赖 32 位 Windows 本机编译、运行测试或生成文档，则还需要迁移开发和 CI 环境。

把交叉编译输入拆成四块

Rustup 的交叉编译文档明确区分了目标标准库与其他工具：rustup target add 只安装目标的 Rust 标准库，链接器、C 运行库和平台 SDK 仍要单独准备。一个最小的目标安装和构建示例可以这样写：

# 在 64 位主机上安装 i686 目标的标准库，不把目标当成主机工具链
rustup target add i686-pc-windows-msvc

# 显式指定目标，避免 Cargo 默默使用主机架构
cargo build --release --target i686-pc-windows-msvc

# 用 rustup 查看目标是否已经安装；缺少 rust-std 时先修复安装输入
rustup target list --installed

迁移清单还应单独检查：

• 构建机：优先使用受支持的 64 位 Windows 主机，CI 镜像不要继续以 32 位 Windows 作为 host。
• 目标 std：在固定 toolchain 下安装 i686-pc-windows-msvc 或 i686-pc-windows-gnu，并把 target triple 写进流水线。
• 链接器：MSVC 目标需要匹配的 Visual Studio C++ 工具和 Windows SDK；GNU 目标需要可用的 MinGW-w64 链接器。
• C 依赖：带有 build script、原生库或 bindgen 的 crate 不能只看 Rust std，必须为 i686 准备对应的头文件、库文件和环境变量。

CI 迁移时保留哪些检查

CI 不必把所有任务一次性改掉，可以先把“构建主机”和“目标产物”拆开。流水线的固定输入应包括主机架构、Rust toolchain、target triple、链接器来源和 C 依赖版本；构建命令显式带 --target，产物检查只确认目标文件和依赖架构，不把某一次成功上传误当成工具链长期可用。

# .cargo/config.toml：只为目标声明链接器，不改变主机 toolchain
[target.i686-pc-windows-msvc]
# 示例路径应替换成 CI 镜像中实际存在的链接器
linker = "i686-pc-windows-msvc-linker"

对仍保留 32 位 Windows 设备的团队，建议把回滚条件写在发布流程旁边：如果目标 std 无法安装、链接器缺失或原生依赖没有 i686 版本，就暂停该目标发布，保留上一版产物，不把主机降回 32 位来“绕过”问题。只有在项目明确需要 32 位主机行为时，才把旧主机作为隔离的遗留构建环境，并安排替换期限。

最后用这份清单收口：1.99.1 的修复项是否已进入稳定工具链；当前 i686 是 target 还是 host；目标 std 是否固定安装；链接器和 C 依赖是否匹配；CI 是否从 64 位主机执行；构建命令是否显式指定 target；失败时是否有暂停和回滚路径。

相关问题

Rust 1.99.1 会立即删除 i686 Windows 的标准库吗？

不会。官方迁移说明保留 i686 Windows 的预编译标准库，变化重点是 host tools 和 32 位 Windows 主机构建能力。

只安装 rust-std 就能完成全部交叉编译吗？

不能。rustup 文档明确说明目标标准库之外通常还需要链接器，带 C 依赖的项目还要准备对应平台的原生工具链。