在 Debian 上安装 Rust 本身不难,真正容易埋坑的地方,往往是安装位置、环境变量以及后续维护方式。尤其在多用户主机或需要长期保留环境的服务器上,前期把这些基础项处理清楚,后面升级、补组件和排障都会省事很多。
下面按“先装好、再验证、最后补齐体验”的顺序,把 Debian 下 Rust 开发环境的配置步骤重新梳理一遍。你可以直接照着执行,也可以根据自己是个人开发机还是共享服务器,判断哪些可选项值得加上。
先更新系统并安装基础依赖
在安装 Rust 之前,建议先刷新 Debian 的软件包索引,并把系统更新到当前状态,尽量减少依赖冲突:
sudo apt update && sudo apt upgrade -y
接着安装 Rust 工具链会用到的基础依赖,包括下载工具和常见编译组件:
sudo apt install curl build-essential gcc make -y
这里的 build-essential 已经包含常见编译工具,文中的 gcc、make 继续单独写出,主要是为了让依赖构成更直观,执行时可直接沿用原命令。
用 rustup 安装 Rust 工具链
rustup 是 Rust 官方推荐的工具链管理器,负责安装和管理 rustc、cargo 以及后续组件。安装命令如下:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --no-modify-path -y
这条命令里有两个参数值得注意:
--no-modify-path:不自动修改系统PATH,便于你手动控制环境变量;-y:自动确认安装过程,适合批量部署或非交互执行。
原文将这一做法与安装到 /opt/rust 的多用户管理思路联系在一起,核心目的都是一致的:不要让安装脚本直接改动当前用户的 shell 配置,把路径和环境控制权保留给系统管理员。
为什么要手动配置环境变量
如果没有自动修改 PATH,那就需要手动把 Rust 相关变量加入系统配置,这样 rustc 和 cargo 才能在全局直接调用:
echo 'export RUSTUP_HOME=/opt/rust' | sudo tee -a /etc/profile.d/rust.sh
echo 'export PATH=$PATH:/opt/rust/bin' | sudo tee -a /etc/profile.d/rust.sh
source /etc/profile # 立即生效
这一做法比较适合需要统一维护环境的场景,原因主要有两点:
- 配置写入
/etc/profile.d/rust.sh后,路径管理更集中; - 后续无论是新增用户还是排查命令找不到的问题,都比逐个用户改 shell 配置更容易。
如果你是在个人开发机上使用,也可以保留这种方式,优点是环境更清晰,后续迁移和维护成本更低。
安装完成后如何验证是否可用
安装完成后,先不要急着建项目,建议先确认编译器和包管理器都已经正常可用:
rustc --version # 查看Rust编译器版本
cargo --version # 查看Cargo版本
如果输出类似下面的版本信息,就说明 Rust 工具链已经安装成功:
rustc 1.75.0 (x86_64-unknown-linux-gnu)
这一步的意义不只是“看见版本号”,更重要的是确认两件事:一是命令路径已经生效,二是当前 shell 会话能够正确调用 Rust 工具链。
可选增强:补齐常用组件与调试工具
如果你的目标不只是“能编译”,而是准备进入日常开发阶段,建议把格式化和静态检查组件一起装上:
rustfmt:统一代码格式;clippy:提供静态分析和潜在问题提示;lldb或gdb:用于调试,文中说明 Debian 默认安装。
rustup component add rustfmt clippy
对于团队项目来说,rustfmt 和 clippy 基本都属于值得尽早装好的工具,越早统一开发习惯,后面越少返工。
依赖下载慢时,配置 Cargo 国内镜像
如果你在拉取 crates 依赖时速度较慢,可以给 Cargo 配置国内镜像。原文示例使用的是清华源,配置方式如下:
mkdir -p ~/.cargo
cat <
这一步属于典型的“非必须但很实用”配置。它不会改变 Rust 本身的安装状态,但会直接影响后续 cargo build、cargo run、cargo add 等操作的依赖下载体验。
用 Hello World 项目做一次完整自检
如果版本命令没有问题,下一步就可以通过一个最小项目验证编译、构建和运行链路是否完整:

cargo new hello_world # 创建项目目录
cd hello_world # 进入项目目录
cargo run # 编译并运行
终端若输出 Hello, world!,通常说明以下几个环节都已经打通:
cargo可以正常创建项目;- Rust 编译器可以完成构建;
- 当前环境具备运行生成程序的基础条件。
相比单纯查看 rustc --version,这一步更接近真实开发过程,因此更适合作为环境验收标准。
编辑器支持与后续升级方式
如果你使用 VS Code,可以继续补上 Rust 语言服务支持:
- 安装 VS Code:从官网下载并安装;
- 打开扩展市场,搜索并安装
rust-analyzer; - 重启 VS Code,启用代码补全、语法检查等能力。
完成以上配置后,Debian 上的 Rust 开发环境就基本齐备了,已经能够覆盖日常编码、构建和基础调试需求。后续如果需要升级 Rust 版本,可直接使用:
rustup update












