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