Debian 搭建 Rust 环境的实用步骤

在Debian上部署Rust开发环境,其实没有想象中那么复杂。关键路径有两条:一条是用官方推荐的rustup,灵活可控,适合日常折腾;另一条是走系统仓库的apt安装,省心但版本偏老。下面咱们就逐个拆解。
一、安装方式选择
- 推荐方式:rustup(Rust官方版本管理器)。它能让你在stable、beta、nightly工具链之间随意切换,还能按需安装rustfmt、clippy、rust-src等组件。日常开发和学新特性,选它准没错。
- 备选方式:Debian官方仓库。一条命令
sudo apt install rustc cargo就完事,版本虽然旧一点,但跑通基础项目绰绰有余,适合不想折腾的场合。
二、快速搭建步骤(rustup 推荐)
- 更新系统,装好基础工具
先跑sudo apt update && sudo apt install -y curl build-essential gcc make,把编译器和依赖工具备齐。 - 安装 rustup
执行官方脚本:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh。装完后记得加载环境:source "$HOME/.cargo/env"。 - 验证安装
检查rustc --version和cargo --version,能看到版本号就说明成了。 - 配置工具链和组件
设置默认工具链:rustup default stable;再装上常用组件:rustup component add rustfmt clippy rust-src。 - 创建第一个项目
cargo new hello && cd hello,然后cargo run跑起来,或者cargo build编译。看到“Hello, world!”就算开局成功。
三、使用系统仓库安装(备选)
- 一条命令搞定:
sudo apt update && sudo apt install -y rustc cargo。 - 验证同样用
rustc --version和cargo --version。 - 需要注意的是,系统仓库的版本通常滞后于官方最新稳定版。如果你需要尝鲜或者对版本有精确要求,还是回头用 rustup 吧。
四、进阶配置与常用任务
- 环境变量:用 rustup 安装后,一般不需要手动设置。不过为了保险,可以在 shell 配置里加一句
export PATH="$HOME/.cargo/bin:$PATH"。 - 更新与切换工具链:
更新:rustup update
切换:rustup default stable|beta|nightly - 交叉编译(以 ARMv7 为例):
添加目标:rustup target add armv7-unknown-linux-gnueabihf
然后cargo build --target armv7-unknown-linux-gnueabihf构建。 - 打包成 .deb 文件:
先装工具:cargo install cargo-deb
在项目根目录执行cargo deb,生成的 .deb 在target/debian/下。用sudo dpkg -i target/debian/*.deb安装即可。
五、常见问题与排查
- 命令找不到? 运行
source "$HOME/.cargo/env",或者检查 ~/.bashrc / ~/.zshrc 里是否包含$HOME/.cargo/bin在 PATH 中。 - 编译失败,提示缺头文件或链接器? 回头装上
build-essential等基础开发包,问题多半能解决。 - 想要最新稳定版或夜版尝鲜? 记住:优先用 rustup,别跟系统仓库较劲。