Windows 下如何配置 Rust 开发环境变量 PATH？

推荐直接使用 rustup 安装器自动配置 PATH，手动修改仅在安装失败或特殊隔离环境时使用。风险边界在于区分用户变量与系统变量，错误修改系统 PATH 可能导致其他软件异常。

先说结论：Windows 下配置 Rust 环境变量首选 rustup 自动安装，手动配置需添加 %USERPROFILE%\.cargo\bin 到用户 PATH。

命令速用版

自动安装使用官方初始化命令，手动添加 PATH 使用 setx 命令写入注册表。

rustup init -y

setx PATH "%PATH%;%USERPROFILE%\.cargo\bin"

注意：setx 命令会导致 PATH 变量长度截断风险，优先推荐使用图形界面编辑环境变量。

PATH 环境变量告诉 Windows 操作系统去哪里查找可执行文件。

Rust 的工具链二进制文件默认存放在用户目录下的 .cargo\bin 文件夹，若该路径不在 PATH 中，终端无法识别 rustc 或 cargo 命令。rustup 安装脚本会自动将该路径追加到当前用户的 PATH 变量中，无需手动干预。

优先运行安装器自动配置，若失败再手动编辑系统设置。

1. 下载并运行 rustup-init.exe，保持默认选项直至完成。

2. 若需手动配置，右键“此电脑”选择“属性”，进入“高级系统设置”。

3. 点击“环境变量”，在“用户变量”栏找到 Path，点击“编辑”。

4. 新建条目，输入 %USERPROFILE%\.cargo\bin，连续点击确定保存。

5. 关闭并重新打开命令行终端，使变量更改生效。

通过版本号查询命令确认工具链可被系统调用。

打开 PowerShell 或 CMD，输入 rustc `--version` 和 cargo `--version`。

若显示版本号而非“不是内部或外部命令”，则 PATH 配置成功。

终端缓存旧环境变量或路径拼写错误会导致配置无效。

1. 修改环境变量后未重启终端，旧进程仍使用旧 PATH。

2. 手动输入路径时拼写错误，如将 .cargo 写成 cargo。

3. 使用 setx 命令多次追加导致 PATH 超出长度限制被截断。

4. 在系统变量而非用户变量中修改，可能需要管理员权限且风险较高。

不需要重启电脑，只需关闭并重新打开命令行终端即可。

检查用户环境变量 Path 中是否包含 %USERPROFILE%\.cargo\bin 路径。

可以但不推荐，用户变量配置更安全且不影响其他系统用户。