1. 默认安装路径(通过rustup安装)
使用官方推荐的rustup工具安装Rust时,工具链及相关文件的默认存储位置如下:

- Rustup主目录:用于存放Rustup自身的元数据、工具链清单以及自定义配置(例如镜像源)。默认路径固定为
$HOME/.rustup(普通用户对应~/.rustup,root用户则为/root/.rustup)。 - Cargo主目录:Cargo(Rust包管理器)的配置文件、缓存数据以及工具链组件(如
rustc、cargo可执行文件)均保存在此。默认路径为$HOME/.cargo。 - 工具链可执行文件目录:核心工具包括
rustc(编译器)、cargo(包管理器)和rustup(版本管理器),它们统一存放在$HOME/.cargo/bin目录下。安装过程中该目录会自动加入系统的PATH环境变量,因此安装完成后即可全局直接调用,无需额外配置。
2. 自定义安装路径(可选)
若不想使用默认位置,也可以通过环境变量进行自定义修改:
RUSTUP_HOME:用于指定Rustup主目录。例如设置export RUSTUP_HOME="/opt/rust/.rustup"后,工具链的元数据便会存储到该自定义目录。CARGO_HOME:用于指定Cargo主目录。例如设置export CARGO_HOME="/opt/rust/.cargo"后,所有工具链组件和配置都会迁移至此目录。修改后,可执行文件目录会自动更新为$CARGO_HOME/bin,务必同时将此新路径添加到PATH中,否则系统将无法找到对应命令。
3. 验证路径的方法
安装完成后,如何确认路径配置是否正确?这里提供三种简便方法:
- 执行
echo $PATH命令,检查输出中是否包含$HOME/.cargo/bin(或你自定义的$CARGO_HOME/bin)。 - 直接进入目标目录查看文件列表:运行
ls -l $HOME/.cargo/bin,确认目录下是否存在rustc、cargo等可执行文件。 - 使用
rustup which rustc命令,该命令会直接显示rustc的完整绝对路径(例如/home/username/.cargo/bin/rustc),这是最为直观的验证方式。
注意事项
- 如果未对环境变量进行自定义配置,普通用户的工具链默认存储在家目录下(
~/.rustup和~/.cargo),而root用户的工具链则会存放在系统根目录(/root/.rustup、/root/.cargo)。 - 安装完成后,如果输入
rustc或cargo命令没有反应,大概率是PATH环境变量中缺少$HOME/.cargo/bin路径。此时只需执行source ~/.bashrc(或你当前使用的Shell对应的配置文件)重新加载环境变量即可解决问题。
