野渡
搜索 K

主题

关系图谱

Windows Rust 安装配置

488 字 2 分钟

属性 2
author
wwvo
status
Active

Windows Scoop Rust 安装与清华镜像配置指南 ​

本文档适用于：

  • Windows 系统
  • 已安装 Scoop
  • 需要安装 Rust 并使用清华大学 TUNA 镜像加速

1. 安装 rustup（通过 Scoop） ​

在 PowerShell 中执行：

powershell
scoop install rustup

安装完成后检查版本：

powershell
rustup --version

2. 配置 rustup 使用清华镜像（TUNA） ​

Note

setx 为持久化环境变量。执行后需重新打开终端才会生效。

2.1 持久化设置（推荐） ​

powershell
setx RUSTUP_DIST_SERVER "https://mirrors.tuna.tsinghua.edu.cn/rustup"
setx RUSTUP_UPDATE_ROOT "https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup"

如需取消设置：

powershell
[Environment]::SetEnvironmentVariable("RUSTUP_DIST_SERVER", $null, "User")
[Environment]::SetEnvironmentVariable("RUSTUP_UPDATE_ROOT", $null, "User")
[Environment]::SetEnvironmentVariable("RUSTUP_DIST_SERVER", $null, "Machine")
[Environment]::SetEnvironmentVariable("RUSTUP_UPDATE_ROOT", $null, "Machine")

2.2 当前终端立即生效（可选） ​

powershell
$env:RUSTUP_DIST_SERVER = "https://mirrors.tuna.tsinghua.edu.cn/rustup"
$env:RUSTUP_UPDATE_ROOT = "https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup"

3. 安装并启用 stable 工具链 ​

powershell
rustup toolchain install stable
rustup default stable

可选：升级到最新 stable

powershell
rustup update stable

4. 验证安装结果 ​

powershell
rustup show
rustc -V
cargo -V

若命令均正常返回版本信息，说明安装成功。

5. 配置 cargo 使用清华 crates 镜像 ​

编辑（或新建）文件：C:\Users\admin\.cargo\config.toml

powershell
scoop install extras/vcredist2022 main/uutils-coreutils
mkdir C:\Users\admin\.cargo
touch C:\Users\admin\.cargo\config.toml

写入以下内容：

toml
[source.crates-io]
replace-with = "mirror"

[source.mirror]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

[registries.mirror]
index = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

[net]
git-fetch-with-cli = true
Warning

如果你已有 config.toml，请合并配置，避免覆盖现有其他源设置。

6. 快速自检命令 ​

powershell
rustup show
rustup toolchain list
cargo search serde --registry mirror
  • cargo search serde --registry mirror 可用于验证镜像索引访问是否正常。

7. 拉包慢或失败排查 ​

  • 检查 C:\Users\admin\.cargo\config.toml 是否配置正确
  • 确认 registry 使用 sparse+https://.../ 格式，且末尾包含 /
  • 若出现 crates-io is replaced with non-remote-registry source registry 'mirror'，使用：
powershell
cargo search serde --registry mirror
  • 若要临时绕过替换并查询官方 crates-io，使用：
powershell
cargo search serde --registry crates-io

8. 推荐后续操作 ​

安装常用组件：

powershell
rustup component add rustfmt clippy

在 VS Code 中安装 rust-analyzer 插件，以获得更好的 Rust 开发体验。

参考文档：