Skip to content

Windows 安装 Rust 不踩坑:告别 MSVC 依赖,一条命令搞定

在 Windows 上安装 Rust,大概是新手劝退率最高的环节之一。打开 rustup.rs,网页第一句话就告诉你:需要安装 Microsoft C++ Build Tools。光是这一步,就足以让不少人关掉页面。

本文梳理 Windows 装 Rust 的几个典型坑,并介绍如何用一条命令跳过所有麻烦。

MSVC:绕不开的"官方方案"

Rust 在 Windows 上的默认工具链是 x86_64-pc-windows-msvc,编译时需要 MSVC 链接器。这意味着你必须安装以下二选一:

  • Visual Studio(社区版免费,但完整安装 10 GB 起步)
  • Visual Studio Build Tools(精简版,仍需 3-5 GB)

安装过程中还要在 Workload 列表里勾选"C++ 桌面开发",组件名称一长串,选错就白装。整个流程跑完至少 30 分钟,磁盘多占好几个 GB——只是为了一个链接器。

对于只想写 Rust 的开发者来说,这个代价太大了。

GNU 工具链:更轻量,但配置门槛不低

Rust 其实支持另一套工具链 x86_64-pc-windows-gnu,用 GCC 替代 MSVC 作为链接器,完全不需要 Visual Studio。

问题在于:你得先装好 MinGW-w64,并且把 gcc.exe 所在目录加入 PATH。大多数教程到这里就一笔带过,新手很容易下错版本、放错路径,最后 rustup 装完却编译报错,排查半天才发现是 MinGW 没配对。

国内网络:crates.io 的另一道坎

即使工具链装好了,cargo build 拉依赖时还会遇到 crates.io 访问慢甚至超时的问题。需要手动编辑 ~/.cargo/config.toml 配置国内镜像源,又是一轮搜索和复制粘贴。

用 hudo 一条命令搞定

hudo 是一个 Windows 开发环境引导工具,把上面这些步骤全部自动化了:

powershell
hudo install rust

执行后 hudo 会:

  1. 自动检测 MinGW——如果系统中没有 gcc,会提示你一键安装 MinGW-w64,无需手动下载和配置
  2. 使用 GNU 工具链——默认安装 x86_64-pc-windows-gnu,彻底跳过 MSVC
  3. 自动配置 USTC 镜像——rustupcrates.io 的下载源都切换到中科大镜像,国内网络也能流畅使用

自动配置的环境变量

安装完成后,hudo 会写入以下环境变量(用户级,无需管理员权限):

变量说明
RUSTUP_HOMErustup 数据目录
CARGO_HOMECargo 和工具链目录
PATH自动追加 cargo/bin

所有路径统一管理在 hudo 安装根目录下,卸载时 hudo uninstall rust 即可干净移除。

验证安装

打开一个新的终端窗口(环境变量需要新终端才生效),运行:

powershell
rustc --version
cargo --version

看到版本号输出就说明安装成功。再创建一个测试项目确认编译正常:

powershell
cargo new hello
cd hello
cargo run

终端打印出 Hello, world! 就大功告成了。

总结

Windows 上装 Rust 的核心痛点在于链接器依赖和网络环境。选择 GNU 工具链可以避开 MSVC 的巨大开销,而 hudo 把 MinGW 安装检测、工具链选择、镜像配置这些琐碎步骤打包成了一条命令。

如果你正准备在 Windows 上开始 Rust 之旅,不妨试试:

powershell
hudo install rust

少折腾环境,多写代码。

基于 MIT 协议发布