直接装rustup即可自动带cargo；换源需配两处：RUSTUP_DIST_SERVER（工具链下载）和~/.cargo/config.toml（crate依赖），缺一不可；安装失败主因是static.rust-lang.org被限速或DNS污染，应删残留、设镜像、source环境变量并装build-essential。
直接装 rustup 就行，cargo 会自动带上；换源分两层——rustup 工具链下载用 RUSTUP_DIST_SERVER，crate 依赖下载用 ~/.cargo/config.toml，漏掉任何一层都会卡住或超时。
rustup 安装失败常见原因和绕过方法
执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 卡在 downloading component 'rustc'，不是网络断了，是官方 CDN（static.rust-lang.org）在国内被限速或 DNS 污染。
- 别等，先
Ctrl+C中断，再删残留：rm -rf $HOME/.rustup $HOME/.cargo - 设镜像变量（只对当前 shell 有效）：
export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup - 再跑安装命令，不要跳过
source "$HOME/.cargo/env"——否则cargo命令根本不存在 - 验证：
cargo --version和rustc --version都能输出才算真正就位
为什么装完 cargo build 还报 error: linker `cc` not found
Rust 编译器不自带链接器，cargo build 默认调用系统 cc（通常是 gcc），但最小化安装的 Linux（比如云服务器、WSL2）压根没装 C 工具链。
猫目
AI工具导航与智能应用推荐
- Ubuntu/Debian：
sudo apt install build-essential（仅装gcc不够，build-essential还含make、libc6-dev等） - CentOS/RHEL/Fedora：
sudo dnf groupinstall "Development Tools" - Arch Linux：
sudo pacman -S base-devel - WSL2 用户建议额外加装：
sudo apt install libssl-dev，否则像reqwest这类 crate 会编译失败 - 验证是否生效：
cc --version能输出版本号，且cargo build不再报 linker 错误
换源必须配两处，只改 cargo config 不解决工具链下载慢
cargo 下载依赖走 crates.io，而 rustup 下载 rustc、cargo 自身二进制包走的是另一个地址（static.rust-lang.org），两者镜像源不同，不能混用。
- 工具链下载换源（影响
rustup install/rustup update）：rustup set dist-server https://mirrors.tuna.tsinghua.edu.cn/rust-static - crate 依赖换源（影响
cargo build/cargo add）：
编辑~/.cargo/config.toml，写入：
[source.crates-io] replace-with = "ustc" [source.ustc] registry = "https://mirrors.ustc.edu.cn/crates.io-index"
- 改完不用重启，直接
cargo search rand测试是否走镜像 —— 如果返回结果快且无超时，说明生效 - 别碰
RUSTUP_UPDATE_ROOT，它只管rustup自身更新，跟工具链下载无关
容易被忽略的细节：环境变量加载时机和权限问题
source "$HOME/.cargo/env" 只对当前终端生效；新开终端或 VS Code 内置终端默认不加载，就会提示 command not found: cargo。
- 永久生效：把这行加到
~/.bashrc或~/.zshrc末尾，然后source ~/.bashrc - 如果用
sudo启动 IDE（比如sudo code），IDE 会继承 root 的环境，但$HOME/.cargo/env是用户级路径，root 找不到 —— 改用普通用户启动 IDE - 某些企业网络会拦截 HTTPS 的 SNI 域名（比如访问
static.rust-lang.org时），表现为连接超时但无明确错误，此时只能换网络或配代理，镜像也救不了
