Windows运行Rust项目必须安装完整工具链：rustup（版本管理器）、rustc（编译器）、cargo（构建与包管理器）三者缺一不可，且须按rustup→rustc→cargo顺序配置；安装时需同步安装Microsoft C++ Build Tools，否则链接失败。
要在Windows上运行Rust项目，必须先安装完整的工具链——它不是单个.exe文件，而是由rustup（安装器+版本管理器）、rustc（编译器）和cargo（构建与包管理器）三者协同工作的系统；缺一不可，且顺序不能颠倒。
下载并运行rustup安装器
打开浏览器，访问 https://www.php.cn/link/c2ceafe55feb2a3458657d8dd2e1965e，点击「Download rustup-init.exe (64-bit)」按钮，将文件保存到桌面（路径明确，避免后续找不到）。
双击桌面的 rustup-init.exe，弹出黑色命令行窗口；此时直接按 1 回车，选择默认安装（stable通道 + 全组件），新手切勿选2自定义——漏装 rust-docs 或 rust-std 会导致后续 cargo doc 失败或交叉编译报错。
安装过程中若弹出提示「Microsoft C++ Build Tools not found」，必须点「Install」并等待其完成；【不装此工具，cargo build 将在链接阶段失败，报错 LNK1104: cannot open file 'ucrtd.lib'】。安装完后窗口显示 Rust is installed now. Great!，按回车关闭即可。
刷新环境变量并验证核心命令
这一步极易被跳过：关闭所有已打开的 PowerShell、CMD、IDE终端窗口，右键桌面→「在终端中打开」→选择「Windows Terminal（PowerShell）」或直接搜索打开新 PowerShell。
依次执行以下三条命令：
rustc --version
cargo --version
rustup --version
每条命令都必须输出形如 cargo 1.90.0 (1e70b85a3 2025-09-04) 的版本字符串；若出现 'cargo' 不是内部或外部命令，说明环境变量未生效——请确认是否重启了终端，而非仅新建标签页。
配置国内镜像源加速依赖下载
方法一：通过系统环境变量（推荐，全局生效）
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→在「系统变量」区域点击「新建」：
变量名：RUSTUP_DIST_SERVER，变量值：https://mirrors.ustc.edu.cn/rust-static
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案，可稳定把窗口收进托盘且不闪控制台。
变量名：RUSTUP_UPDATE_ROOT，变量值：https://mirrors.ustc.edu.cn/rust-static/rustup
方法二：手动创建 Cargo 配置文件（仅影响当前用户）
打开文件资源管理器，地址栏输入 %USERPROFILE%\.cargo 回车；若该目录不存在，请手动新建。【在此目录下新建一个纯文本文件，命名为 config（无任何扩展名！命名成 config.toml 或 config.txt 均无效）】
用记事本打开 config 文件，粘贴以下内容并保存：
[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = 'https://mirrors.ustc.edu.cn/crates.io-index'
创建并运行第一个Rust程序
第一步：用 cargo 创建新项目
cargo new hello_world → cd hello_world
第二步：编辑 src/main.rs，确保内容为标准 Hello World：
fn main() {
println!("Hello, world!");
}
第三步：编译并立即运行
cargo run
终端将输出 Finished dev [unoptimized + debuginfo] target(s) in X.XXs，紧接着打印 Hello, world!；这表示 rustc 已成功调用，cargo 构建流程完整打通，开发环境就绪。
