Skip to content

Rust 开发踩坑笔记

碎碎念:

国内 Rust 开发环境搭建总被网络问题卡脖子,实测中科大镜像源最稳定。

安装 Rust 时下载龟速

配置中科大镜像源

在 PowerShell 中运行以下命令:

# 设置临时镜像变量
$env:RUSTUP_DIST_SERVER = "https://mirrors.ustc.edu.cn/rust-static"
$env:RUSTUP_UPDATE_ROOT = "https://mirrors.ustc.edu.cn/rust-static/rustup"

安装完成后,永久生效配置需设置系统环境变量:

# 设置 RUSTUP_DIST_SERVER
[Environment]::SetEnvironmentVariable("RUSTUP_DIST_SERVER", "https://mirrors.ustc.edu.cn/rust-static", "Machine")

# 设置 RUSTUP_UPDATE_ROOT
[Environment]::SetEnvironmentVariable("RUSTUP_UPDATE_ROOT", "https://mirrors.ustc.edu.cn/rust-static/rustup", "Machine")

cargo build 依赖下载超时

配置 Cargo 国内源:编辑 ~\.cargo\config

[source.crates-io]
replace-with = 'ustc'

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

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

[http]
check-revoke = false  # 解决 Windows 下的证书问题

# 清华源(备用)
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

# 字节跳动源(企业级)
[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

注意

  • 若使用 Rust 1.68 以下版本,需删除 sparse+ 前缀
  • 修改后建议清理缓存:cargo clean

缓存清理

遇到玄学问题时,依次执行:

# 清理 Rust 编译产物
cargo clean

# 重置工具链
rustup self uninstall
rustup update

# 暴力删除缓存
rm -r ~\.cargo\registry
rm -r ~\.rustup\tmp