Ubuntu Rust环境变量怎么设置

Ubuntu 下 Rust 环境变量设置指南

一 安装后自动配置与立即生效

• 使用官方脚本安装后，推荐直接加载安装脚本写入的环境：执行命令：source $HOME/.cargo/env。这会设置 PATH 等变量，使 cargo/rustc/rustup 可用。若使用 bash，也可写入 ~/.bashrc 并在新开终端自动生效。安装命令示例：curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh。完成后可用 rustc --version、cargo --version 验证。

二 手动设置关键环境变量

• 仅设置 PATH（最常见）：在 ~/.bashrc 或 ~/.zshrc 末尾添加：export PATH=“$HOME/.cargo/bin:$PATH”，然后执行 source ~/.bashrc 或 source ~/.zshrc。
• 指定 Cargo 目录（可选）：export CARGO_HOME=“$HOME/.cargo”。
• 指定工具链目录（可选，便于多版本管理）：export RUST=“$HOME/.rustup/toolchains/stable-x86_64-unknown-linux-gnu”。
• 指定源码路径（仅在需要本地标准库源码时使用，如部分工具/插件）：export RUST_SRC_PATH=“$RUST/lib/rustlib/src/rust/src”。
• 使配置立即生效：执行 source ~/.bashrc 或 source ~/.zshrc。

三 国内镜像与 Cargo 配置（可选）

• 提升安装/更新速度（rustup 镜像）：在 ~/.bashrc 或 ~/.profile 中添加：
  • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
• 提升依赖下载速度（crates.io 索引镜像）：创建或编辑 ~/.cargo/config.toml，示例：
  • 使用清华源（稀疏索引）：
    • [source.crates-io]
    • replace-with = ‘tuna’
    • [source.tuna]
    • registry = “sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/”
  • 使用 USTC 源（git 索引）：
    • [source.ustc]
    • registry = “git://mirrors.ustc.edu.cn/crates.io-index”
  • 可选网络优化：
    • [net]
    • git-fetch-with-cli = true
• 使配置生效：source ~/.bashrc 或 source ~/.profile。

四 验证与常见问题

• 验证命令：
  • rustc --version、cargo --version、rustup --version
  • 查看工具链：rustup show
  • 若命令未找到，检查 PATH 是否包含 $HOME/.cargo/bin，并确认已执行 source 或重启终端。
• 常见问题与处理：
  • 安装或更新缓慢：配置上文的 RUSTUP_DIST_SERVER / RUSTUP_UPDATE_ROOT 与 Cargo 镜像源。
  • 需要本地 Rust 源码（如 racer/部分 IDE 功能）：设置 RUST_SRC_PATH 指向本地源码目录（路径需与已安装工具链匹配）。
  • 多用户或系统级安装：将变量写入 /etc/profile.d/rust.sh 或相应 profile 文件，注意权限与路径一致性。