常见问题

> 安装与环境配置的常见问题汇总，包括下载加速、PATH 配置和工具链管理。

常见问题

Q1: 下载慢怎么办？

配置国内镜像（中科大）：

mkdir -p ~/.cargo

cat > ~/.cargo/config.toml << 'EOF'
[source.crates-io]
replace-with = 'ustc'

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

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

Q2: 编译错误：找不到 rustc

加载环境变量：

source "$HOME/.cargo/env"

# 或添加到 shell 配置
echo 'source "$HOME/.cargo/env"' >> ~/.bashrc  # bash
echo 'source "$HOME/.cargo/env"' >> ~/.zshrc   # zsh

Q3: 如何卸载 Rust？

rustup self uninstall

Q4: 如何更新 Rust？

rustup update

Q5: 如何查看本地文档？

rustup doc              # 标准库文档
rustup doc --book       # Rust Book

Q6: rust-analyzer 报错？

确保已安装 rust-analyzer 组件：

rustup component add rust-analyzer

重启 VS Code。

---

常用命令速查

# 安装与更新
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup update
rustup self uninstall

# 版本检查
rustc --version
cargo --version
rustup --version

# 项目管理
cargo new <name>           # 创建可执行项目
cargo new <name> --lib     # 创建库项目

# 构建与运行
cargo run                  # 运行（调试模式）
cargo run --release        # 运行（发布模式）
cargo build                # 构建
cargo check                # 快速检查
cargo test                 # 测试

# 质量
cargo fmt                  # 格式化
cargo clippy               # 代码检查

# 文档
cargo doc --open           # 生成文档
rustup doc                 # 标准库文档

小结

• 安装慢：配置 RUSTUP_DIST_SERVER 使用国内镜像
• PATH 未配置：将 ~/.cargo/bin 加入环境变量
• 工具链更新：rustup update 升级，rustup show 查看当前版本
• 遇到问题优先阅读编译器错误信息

练习题

详见：练习题