在 Windows 上装 Rust看起来是件小事下载一个安装包双击一路回车结束。但我带过的新人里十个有六个卡住的不是这一步——rustup 本身几乎是傻瓜式的真正让人原地打转的是它背后那个链接器。rustc 打印版本号打印得挺开心cargo run一敲屏幕甩出一行error: linker link.exe not found然后就不知道往哪走了。还有人装完发现终端里cargo命令认识换一个终端窗口就不认识了重启电脑才好也有人折腾一下午最后发现是路径里带了个中文目录。这篇东西就是把我自己在 Windows 上做windows 安装 rust这件事的完整流程、踩过的坑、以及后面那些“装完才算开始”的配置一次讲透。核心围绕三样东西rustup 版本管理器、工具链MSVC 或 GNU、以及链接器与系统依赖。看完你应该能做到从一台干净的 Windows 机器出发装好一套能正常编译、能跑测试、能装第三方 crate 的环境并且知道每个选项为什么这么选。适合谁看完全没碰过 Rust 的新手可以照着抄从其他语言转过来、被链接错误劝退过一次的可以跳过前面看排查部分已经装好了但总觉得编译慢、依赖拉不下来的直接看镜像和提速那两节。我不打算写成一板一眼的说明书就把我实际操作时的顺序和判断依据摆出来。1. 装之前先搞清楚Windows 上的 Rust 到底由什么组成很多人对“安装 Rust”的理解是“装一个叫 Rust 的软件”这个心智模型从一开始就错了后面所有的困惑都从这儿长出来。Rust 不是单个可执行文件它是一套由版本管理器托管的、可以多版本共存的工具集合。你在命令行敲的rustc、cargo、rustfmt、clippy本质上都是被 rustup 放进 PATH 里的转发器shim真正的二进制文件躺在另一个带版本号的目录里。1.1 rustup、工具链、链接器三个角色别搞混我把这三者的关系类比成“游戏启动器 游戏本体 显卡驱动”。rustup 是启动器负责下载、切换、更新工具链toolchain是游戏本体一个工具链就是一套完整的rustc cargo 标准库名字长这样stable-x86_64-pc-windows-msvc拆开读是「发布通道 - 架构 - 操作系统 - ABI」链接器是显卡驱动负责把编译出来的中间产物拼成最终的.exe它不属于 Rust而是来自 C 的编译环境。这个划分为什么重要因为 90% 的安装失败都发生在第三个角色上。rustup 装工具链这一步极少出问题出问题的是“工具链找不到链接器”。所以正确的安装顺序不是“先装 Rust 再说”而是先把链接器准备好再装 Rust让它在安装时就能自检通过。1.2 MSVC 与 GNU 两条路选错了后面全是坑Windows 上官方提供两种 ABI 的工具链安装包也分两个对比项x86_64-pc-windows-msvcx86_64-pc-windows-gnu链接器来源Visual Studio 生成工具的link.exe随工具链打包的 MinGW 版链接器是否需要额外安装需要约 2 到 4 GB不需要开箱即用与系统库、第三方 C 库的兼容性最好绝大多数 crate 默认按这条链路测试部分 crate 会失败或需要手工改链接参数调试体验配合rust-lldb或生成工具自带的调试器依赖 gdb配置麻烦官方 CI 覆盖主路径回归测试最全有覆盖但优先级低一档适合谁几乎所有 Windows 开发者磁盘极度紧张、或需要和既有 MinGW 工程混编新手看到 GNU 版本“不用装额外东西”就想选它这个诱惑我理解但我不建议。原因很实际你迟早会引入某个带 C 依赖的 crate一旦它在 GNU 链路上报cannot find -lgcc_s这类错误排查成本远超你省下来的那 3 GB 磁盘。MSVC 是官方主推路径生态里的默认假设就是它走人多的路出问题时能搜到的答案也多。提示已经装了 GNU 工具链也不必重装整个环境后面第 7 节讲怎么用 rustup 补装并切换两条链路可以共存。1.3 磁盘空间和权限先算清楚再动手给个实际数字Visual Studio 生成工具勾选 C 桌面开发后安装完大约占 2.5 到 4 GB含 Windows SDKRust 工具链本身stabledefault profile约 1.2 GB加上~/.cargo里的依赖缓存一个能正常干活的环境预留 8 GB 比较稳妥。如果你的系统盘常年飘红可以走第 4 节的环境变量搬家方案把CARGO_HOME和RUSTUP_HOME指到别的盘。权限方面安装生成工具需要管理员权限装 rustup 不需要——rustup 默认装到用户目录这是好事避免了全局污染。但要注意一种情况如果公司电脑做了策略限制用户目录被重定向到网络盘编译速度会慢到无法忍受这时候要么跟 IT 沟通要么老老实实改CARGO_HOME。2. 先把底座搭稳生成工具与系统环境准备这一节是整篇文章最不酷但最值钱的部分。我的习惯是在跑任何 Rust 安装程序之前先把 C 编译环境装好、验证通过再去装 Rust。顺序反过来也能成但你会在 rustup 的最后一步看到一个黄色的警告然后开始怀疑人生。2.1 生成工具的组件勾选多一个少一个都不行去官方站点下载「生成工具」安装器注意不是完整的 IDE我们只要编译能力。运行后进入工作负载界面勾选使用 C 的桌面开发。勾完之后右侧的详细信息里会自动带上一堆组件其中这两项是关键MSVC v143 生成工具x64/x86 最新版提供link.exe、cl.exe、lib.exe这是 Rust 编译的最后一步必需的东西。Windows 10/11 SDK提供系统库的导入库.lib和头文件。少了它链接阶段会报一堆LNK1104 无法打开文件 kernel32.lib之类的错误。其余的比如 CMake、测试工具、诊断工具可以按需砍掉能省一两个 G。但不要手动取消 MSVC 生成工具或 SDK——我见过有人为了省空间只勾了个“C 核心功能”结果 rustup 检测通过、编译却报错因为检测逻辑只看link.exe在不在不看你 SDK 全不全。安装完成后验证一下打开普通命令提示符不用管理员where link如果输出为空别急着怀疑人生可能只是 PATH 还没生效。生成工具的link.exe通常不会加入全局 PATHRust 是通过注册表和环境变量定位它的。更靠谱的验证方式是直接找文件dir C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC能看到带版本号的目录比如14.4x.xxxxx就说明 VC 工具装上了。这一步过了后面的路就顺了。2.2 路径、编码、杀软三个容易被忽略的前置条件路径里不要有中文和空格。这一条在 2024 年之后已经宽松很多cargo对 Unicode 路径的处理基本没问题但第三方构建脚本build.rs调用外部工具的那些仍然时不时翻车。最省心的做法是如果你的 Windows 用户名是中文比如C:\Users\张三强烈建议直接把CARGO_HOME和RUSTUP_HOME改到D:\rust\cargo和D:\rust\rustup这类纯 ASCII 路径下。这个改动五分钟能省掉未来无数个“为什么只有这个 crate 编译不过”的深夜。控制台编码。默认的代码页是 GBKcargo build的输出里一旦有非 ASCII 字符比如某些 crate 的构建脚本输出就会显示成乱码虽然不影响编译结果但排查错误时很误导。可以临时用chcp 65001切到 UTF-8或者在 Windows 终端的设置里把默认编码改成 UTF-8。杀毒软件的实时防护。Rust 编译会产生大量小文件target目录动辄几万个文件实时扫描会让编译时间翻倍甚至更多。我的做法是把项目目录和CARGO_HOME加入排除列表。另外偶尔会出现link.exe被杀软拦截导致编译中断的情况症状是编译到链接阶段突然报“拒绝访问”这种时候去防护日志里翻一下就能确认。2.3 环境变量搬家给系统盘减负的正确姿势想把 Rust 的家目录挪走在装 rustup之前设置好两个用户环境变量即可顺序很重要setx CARGO_HOME D:\rust\cargo setx RUSTUP_HOME D:\rust\rustupsetx写的是用户级持久变量写完要开新终端才生效。这两个变量的分工是RUSTUP_HOME存工具链本体每个版本一个子目录CARGO_HOME存 cargo 自己的二进制、crate 缓存、以及后面的配置文件。RUSTUP_HOME体积大且只增不减CARGO_HOME里的 registry 缓存可以用cargo cache之类的工具清理分开放在不同磁盘上也是一种思路。注意如果已经装过 rustup 再改这两个变量等于把家目录“搬走”旧目录里的工具链不会被自动迁移你得把整个目录手动复制过去或者干脆卸了重装。我一般建议在干净的机器上一次到位。3. rustup 安装实操菜单里每一项到底在问什么环境准备好终于可以跑安装程序了。官方页面会给你两个下载链接选x86_64-pc-windows-msvc那个除非你明确要走 GNU。文件叫rustup-init.exe只有几 MB双击运行会弹出一个黑框先是欢迎语然后是一段很长的英文说明最后停在三个选项上。3.1 三个选项选 1 还是选 2菜单长这样1) Proceed with installation (default) 2) Customize installation 3) Cancel installation绝大多数教程让你直接按 1。我的建议是第一次装的人按2花两分钟看一眼默认值尤其是下面这几项Default host triple默认x86_64-pc-windows-msvc。如果你下载错了安装包比如下成了 GNU 版这里会显示-gnu这时候退出去重下比硬装要好。Default toolchain默认stable。别选 nightly除非你在做需要不稳定特性的实验nightly 的编译产物和 stable 不兼容混用会浪费大量时间。Profile默认default包含rustc、cargo、rust-std、rust-docs、rustfmt、clippy。选minimal只装rustc和cargo体积小一半但没有 clippy 和 rustfmt我一般会在装完后手动补这两个组件所以其实default更省事。complete会带上源码和更多文档多占一两个 G。Modify PATH variable?默认Yes。这一项务必保持 Yes它会把%CARGO_HOME%\bin加进用户 PATH。选 No 的话你得自己加忘了就是“cargo 不是内部或外部命令”。看完按回车回到主菜单再按 1 开始安装。下载过程从几十秒到几分钟不等取决于网络状况。如果卡在info: downloading component rust-std十几分钟不动多半是网络问题CtrlC 中断重跑就行rustup 支持断点续传。3.2 装完后的自检清单安装程序最后会打印一行Rust is installed now. Great!。关掉当前终端重新开一个——这是新手最常忽略的一步PATH 的修改不会传染给已经开着的窗口。然后逐条跑rustc --version cargo --version rustup --version rustup show前三条出不来说明 PATH 没生效检查echo %PATH%里有没有\.cargo\bin。rustup show的输出信息量最大它告诉你当前默认工具链、已安装的工具链列表、以及当前目录生效的是哪个如果你在某个带rust-toolchain.toml的项目里这里会显示被覆盖的版本。再补两个组件未来会天天用到rustup component add clippy rustfmtclippy是代码检查工具能在编译前抓出一堆写法问题rustfmt负责格式化。这两个东西加上编辑器插件是 Rust 开发体验的核心。3.3 目录结构长什么样为什么值得看一眼装完之后RUSTUP_HOME下面的结构大致是这样D:\rust\rustup\ ├── downloads\ # 安装包缓存可以放心删 ├── settings.toml # 全局配置记录了默认工具链 ├── toolchains\ │ └── stable-x86_64-pc-windows-msvc\ │ ├── bin\ # rustc.exe、cargo.exe 的真实位置 │ └── lib\rustlib\ └── update-hashes\而CARGO_HOME里是bin\shim 转发器、registry\拉下来的 crate 源码和索引缓存、config.toml下一节的主角。理解这个结构有个实际好处当你遇到“编译出来的东西和想象不一致”时可以直接去toolchains\版本\bin下确认二进制是不是你以为的那个版本。我遇到过一次rustc --version显示 1.75但某个项目死活编译不过最后发现那个项目里有rust-toolchain.toml钉了 1.68rustup 自动装了第二个工具链——rustup show一眼就看到了。4. 让 cargo 顺手起来镜像、缓存与编译提速安装完成到能舒心干活之间还隔着一段配置。核心目的就两个让依赖下得动让编译快得起。这两件事在 Windows 上比在别的系统上更值得调因为默认的单线程链接和目录结构与杀毒软件的交互会让编译明显变慢。4.1 配置 crate 索引镜像别让拉依赖变成等待游戏默认情况下cargo build会去官方索引拉取 crate 元数据和包体。国内网络环境下这一步的体验取决于时段有时几秒有时几分钟。配置镜像能明显改善做法是编辑%CARGO_HOME%\config.toml没有就新建# %USERPROFILE%\.cargo\config.toml [source.crates-io] replace-with mirror [source.mirror] registry sparsehttps://镜像站提供的 sparse 索引地址/ [net] git-fetch-with-cli true三个地方需要解释。第一replace-with是替换不是“备用”配错了会导致所有依赖都拉不到所以填地址时务必确认镜像站给的是 sparse 索引地址以sparse开头而不是老的 git 索引地址。第二sparse协议从 cargo 1.70 起是默认它按需请求单个 crate 的元数据比一次性克隆整个索引快一个数量级如果你的 cargo 版本较老先rustup update再说。第三git-fetch-with-cli true让 cargo 在遇到 git 依赖时调用系统的 git 命令而不是内置的 libgit2这两年内置实现在某些网络环境下握手失败的情况时有发生交给系统 git 更稳。提示镜像站地址各家给的形式不一样有的要求带尾部斜杠有的不需要。填完跑一次cargo new demo cd demo cargo build如果能在十几秒内把依赖元数据拉下来就说明配对了。要是报failed to fetch或者no matching package先把这段配置整个注释掉测试是不是镜像配错导致的这一步能省掉大量误判。4.2 编译提速几个真正见效的开关Windows 上 Rust 编译慢主要慢在链接和文件 IO 上。下面几个做法我实测有效按收益排序把项目放 SSD且排除杀软扫描。收益最大尤其是第一次全量编译。调高并行度。cargo 默认按逻辑核心数分配任务但链接阶段是单线程的。如果你的机器核多内存小反而会因为并行过度导致换页。可以在配置里限一下[build] jobs 8。开发时降级优化等级。[profile.dev]默认opt-level 0如果你想让它跑得快一点比如跑集成测试设成 1 或 2 通常能在编译时间增加不多的情况下大幅提升运行时性能。减少 debug 信息。[profile.dev] debug 1默认是 2完整调试信息能显著减小target目录体积和链接时间。日常开发用 1 足够定位问题。统一 target 目录。多个项目共用一个CARGO_TARGET_DIR可以复用依赖编译产物缺点是并发编译时会锁竞争。我一般只在一个 workspace 内部共享不跨项目全局设置。一份我常用的config.toml组合[build] jobs 8 [profile.dev] debug 1 incremental true [profile.dev.package.*] opt-level 2最后那一段的意思是你自己写的代码不优化所有依赖按 2 级优化编译。这是社区里流传很广的一个技巧因为运行时热点通常在依赖库里比如解析、加密、序列化把它们优化了你的代码迭代速度不受影响程序跑起来却快很多。4.3 编辑器与语言服务器别装重复的插件编辑器我推荐 VS Code 加rust-analyzer扩展这是目前最成熟的组合。有两个细节值得说第一只装 rust-analyzer 一个 Rust 相关扩展把早年的 Rust 官方扩展和其他 RLS 时代的插件全卸了它们会抢同一个语言服务器进程导致补全时好时坏。第二在设置里把保存时的检查从cargo check换成clippy{ rust-analyzer.check.command: clippy, rust-analyzer.cargo.targetDir: true }cargo.targetDir: true的作用是让 rust-analyzer 编译到独立的 target 目录避免和你手动cargo build抢锁——不开这个你会经常看到“正在等待文件锁定”的提示。语言服务器第一次启动会做一次全量索引CPU 占满几分钟是正常的索引存在目标目录里之后启动就快了。如果你打开一个刚克隆的项目发现补全全无、满屏红波浪线八成是索引还没跑完或者依赖没拉下来看一眼右下角的状态就知道了。5. 第一个工程从 cargo new 到 release 打包到这里环境就算齐了。我坚持认为第一个工程不要用rustc main.rs手动编译直接上 cargo因为它会把目录结构、依赖管理、构建配置一次性摆给你看等于免费上了一课。5.1 目录结构与 Cargo.toml 的每个字段cargo new hello_rust cd hello_rust生成了两个东西src/main.rs和Cargo.toml。前者是入口后者是清单文件。清单里默认只有四行[package] name hello_rust version 0.1.0 edition 2021edition值得单独讲一句。它不是 Rust 编译器版本而是语言规则的快照2021 edition 意味着这套代码按 2021 年的语法规则解析。它和工具链版本解耦你用最新的 stable 编译器照样能编译 2015 edition 的老项目。新建项目时 cargo 会自动填当前推荐的 edition不用手改但看到别人的项目写edition 2018时别以为是版本太老要升级——随意改动可能引入破坏性变更。目录里还有一个.gitignore和自动初始化的 git 仓库cargo new默认会git init加--vcs none可以跳过。target/目录在第一次编译后才出现务必确认它在.gitignore里不然仓库体积会爆炸。5.2 跑起来然后看 release 模式的差别cargo run # 编译 运行debug cargo build # 只编译 cargo build --release cargo check # 只做类型检查不生成二进制最快cargo check是我日常用得最多的命令改完代码先 check 一遍比 build 快好几倍语法和类型错误在这一步就能抓干净确认没问题再 build。debug 和 release 的差异比很多人想的大release 开启 3 级优化、关闭调试断言、开启 LTO 的可选配置一个计算密集的小程序两者性能差十倍都不稀奇。但 release 编译也慢得多所以开发期间老老实实用 debug交付前再--release。产物在target\debug\hello_rust.exe和target\release\hello_rust.exe。这个 exe 可以直接拷到其他 Windows 机器上跑前提是对方有 VC 运行时——绝大多数装过日常软件的机器都有如果没有症状是双击闪退或者报缺少VCRUNTIME140.dll。5.3 加一个依赖验证镜像和构建链路是通的空项目跑通不算数加个真实依赖才能验证第 4 节的配置生效了cargo add serde --features derive cargo add serde_json cargo buildcargo add是 cargo 1.62 之后内置的命令不用再装cargo-edit。执行后Cargo.toml里会多出[dependencies]段版本号写成serde { version 1, features [derive] }这种形式。构建过程中你能看到Compiling、Downloaded、Downloading的输出这一步如果很快完成说明镜像配置成功如果卡在Updating crates.io index很久回到 4.1 检查配置。顺带提一个 Windows 特有的东西。如果你写的是 GUI 程序debug 模式下运行时背后会弹出控制台黑窗。加一行属性就能去掉#![windows_subsystem windows]但注意这行只在 release 下生效比较合适debug 时保留控制台方便看println!和 panic 信息所以我一般配合条件编译#![cfg_attr(not(debug_assertions), windows_subsystem windows)]这样 debug 有黑窗方便调试release 自动隐藏一行代码解决。6. 报错排查实录那些让人抓狂的错误信息前面流程走得顺这一节你可以跳过。但根据我的观察第一次在 Windows 装 Rust 的人八成会在这里停下。我把遇到过的、以及帮别人解决过的典型问题整理成表再挑几个展开讲讲排查思路。6.1 常见报错速查表报错信息根本原因处理方式error: linker link.exe not found没装 MSVC 生成工具或装了但版本探测失败补装 C 桌面开发工作负载用rustup default stable-x86_64-pc-windows-msvc确认工具链LNK1104: 无法打开文件 xxx.lib缺 Windows SDK或库路径被污染在生成工具安装器里补勾 Windows SDKerror: could not find Cargo.toml不在项目根目录或在子目录里cd到含Cargo.toml的目录cargo: 无法将cargo项识别为...PATH 没生效重开终端检查%CARGO_HOME%\bin是否在用户 PATHerror: toolchain stable-... is not installed工具链名拼错或被rust-toolchain.toml指定了不存在的版本rustup show看实际生效的工具链rustup toolchain install补齐安装生成工具时报0x80070643/0x80070666旧版运行库冲突或安装缓存损坏清理安装缓存目录后重试必要时先卸旧版本cannot find -lgcc_sGNU 链路MinGW 组件缺失或与系统库不匹配换 MSVC 工具链这是最省事的解法编译到链接阶段报“拒绝访问”杀软拦截link.exe或写入被阻断把项目目录和 cargo 家目录加入排除列表failed to fetch/no matching package镜像配置错误注释掉[source]段用官方源验证再逐项排查编译奇慢风扇狂转实时防护扫描 机械硬盘 全量重编换 SSD、加排除、用cargo check代替 build6.2 三个典型故障的完整排查路径第一个link.exe 找不到但你确信装了生成工具。这种情况我遇到过两次原因完全不同。一次是装的是旧版生成工具rustup 探测逻辑认不出它的路径另一次是装了完整 IDE 但没勾 C 工作负载只有 IDE 壳子没有编译器。排查顺序是先rustup show确认当前工具链是-msvc结尾再手动去C:\Program Files (x86)\Microsoft Visual Studio\2022\下看有没有BuildTools或Community目录进去找VC\Tools\MSVC\版本\bin\Hostx64\x64\link.exe文件在但 rustc 找不到就启动“x64 Native Tools 命令提示符”再跑cargo build这个环境预置了所有路径变量能编译通过就说明是全局环境探测的问题。终极解法是重装生成工具并确保勾选完整。第二个换了个终端 cargo 就没了。症状很明确在 VS Code 的集成终端里能用在系统自带的 cmd 里不能用或者反过来。原因是 PATH 修改只对新启动的进程生效而 VS Code 如果是在改 PATH 之前打开的它的集成终端继承的是旧环境。解决方式是彻底退出 VS Code不是关窗口是从任务栏退出重新打开。还有一种可能是装的时候在 “Modify PATH” 那一步选了 No那就手动加用户变量 PATH 里追加%USERPROFILE%\.cargo\bin。第三个某个 crate 死活编译不过报构建脚本失败。这类问题最难查因为错误信息通常在build.rs的输出里被 cargo 折叠了。技巧是加-vv看完整输出cargo build -vv。我遇到的一次是路径里有中文字符导致某个 C 库的构建脚本传参失败把CARGO_HOME挪到纯 ASCII 路径后解决另一次是缺少某个系统库对应的.lib需要在生成工具里补装对应版本的 SDK。判断方法很简单把项目复制到一个路径为D:\tmp\test的纯英文短路径下再编译一次能过就是路径问题不能过再往下查依赖。提示任何时候看到note: run with RUST_BACKTRACE1 environment variable to display a backtrace别忽略它。设上这个变量再跑一次调用栈会直接把 panic 的位置打出来比盯着错误摘要猜半天有效得多。PowerShell 里就是$env:RUST_BACKTRACE1cmd 里是set RUST_BACKTRACE1。7. 工具链管理多版本共存、切换与干净卸载装好只是开始长期用下去必然会遇到“这个项目要旧版本”“我想试试 nightly 的新特性”这类需求。rustup 在这方面做得相当好理解它的几个命令能省下大量重装时间。7.1 版本切换的三种粒度按影响范围从小到大全局默认rustup default stable改的是settings.toml里的默认值影响所有没被覆盖的目录。按目录覆盖rustup override set 1.75.0在当前目录下写入一个覆盖记录只对这个项目生效。适合临时接手老项目。按项目声明在项目根目录放一个rust-toolchain.toml[toolchain] channel 1.75.0 components [rustfmt, clippy] targets [x86_64-pc-windows-msvc]第三种是团队协作的正解把工具链版本写进仓库谁拉下来都自动用同一个版本rustup 发现缺失会提示安装。这解决了一个很烦的问题不同版本编译器对同一个 crate 的编译结果可能不同线上环境和本地不一致时工具链版本不一致是常见元凶。日常维护用这几条rustup update # 更新所有已安装的工具链 rustup toolchain list # 看装了哪些 rustup component list --installed # 看当前工具链装了哪些组件 rustup target add x86_64-pc-windows-gnu # 加交叉编译目标 rustup self update # 更新 rustup 自身rustup update我一般一周跑一次stable 通道每六周发一个大版本中间的补丁版本主要是修 bug 和安全问题保持更新是划算的。但不要在交付前夜更新新版本偶尔会引入新的 lint 警告#![deny(warnings)]的项目会直接编译失败。7.2 卸载与重装什么时候该推倒重来卸载很简单一条命令rustup self uninstall它会删掉RUSTUP_HOME和CARGO_HOME并从 PATH 里移除对应条目。但有几个残留值得注意项目里的target目录不会删这是对的那是你的构建产物Cargo.lock也不会动。如果你是因为环境坏了要重装建议先备份%CARGO_HOME%\config.toml和%CARGO_HOME%\registry后者是依赖缓存重装后能省下重新下载的时间。什么情况下值得重装而不是修我的判断标准是如果问题是“找不到编译器或链接器”且你已经排查超过一小时重装生成工具 rustup 的总成本通常低于继续深挖。Rust 的安装本身很轻量重来的代价小反倒是被改乱的 PATH 和环境变量越修越乱最后连自己改了什么都不记得。另外提一个容易被忽略的点Windows 上装完 Rust 之后%USERPROFILE%下会多出.cargo和.rustup两个隐藏目录以点开头资源管理器默认不显示。有些人做磁盘清理时看到“未知的大目录”直接删了结果第二天发现所有 Rust 项目都编译不了。如果你有清理习惯把这两个目录加进白名单。双向链路共存这件事也顺带说清楚。想同时保留 MSVC 和 GNU直接rustup toolchain install stable-x86_64-pc-windows-gnu然后在需要的时候rustup default stable-x86_64-pc-windows-gnu切换。两条链路的依赖缓存是分开的target目录里的子目录名带 target triple互不干扰。我通常只在验证某个 crate 的跨平台兼容性时才会切到 GNU日常主力还是 MSVC。装完之后那一周我建议刻意多用cargo check和cargo clippy把这两个命令变成肌肉记忆。Rust 的所有权检查本来就严格clippy 会把很多“能编译但写得不对劲”的地方标出来比如多余的clone()、可以用if let简化的match、性能上有隐患的字符串拼接。刚开始会被警告数量吓到但逐个看完之后你对这门语言的理解会比读十篇教程都快。