概述
Rust 这几年热度一直在涨。系统编程、WebAssembly、CLI 工具,甚至 AI 基础设施,越来越多的项目用 Rust 重写。但很多开发者卡在第一步——不知道如何在服务器上干净地装好 Rust 环境。
这篇文章手把手教你在 VPS 上安装 Rust 开发环境,从 rustup 到 Cargo,再到第一个项目跑起来。全程 10 分钟搞定。
准备工作
你需要以下条件:
- 一台 Linux VPS(Ubuntu 22.04+ 或 Debian 12+)
- SSH 访问权限
- 至少 2GB 磁盘空间(编译过程比较吃空间)
- 至少 1GB 内存(编译大型项目时需要)
第一步:安装系统依赖
Rust 编译需要一些基础工具链。先装上它们:
sudo apt update
sudo apt install -y curl build-essential pkg-config libssl-dev
build-essential 提供 GCC 编译器,libssl-dev 是让 Rust 能编译 OpenSSL 相关库的关键依赖。这一步不能省。
第二步:用 rustup 安装 Rust
rustup 是 Rust 官方推荐的安装和管理工具。一条命令搞定:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
执行后会出现交互式菜单,直接按回车选默认选项就行。安装完成后,让环境变量生效:
source ~/.cargo/env
验证安装是否成功:
rustc --version
cargo --version
正常输出应该是类似这样的:
rustc 1.81.0 (eeb90cda1 2024-09-04)
cargo 1.81.0 (2dbb1af80 2024-08-06)
版本号可能不同,但只要两个命令都能输出信息,就说明装好了。
第三步:配置 Cargo 环境变量
Cargo 是 Rust 的包管理器和构建工具,相当于 Go 的 go mod 加 pip。默认安装路径在 ~/.cargo/bin。
确保你的 shell 配置文件里包含了这个路径。编辑 ~/.bashrc:
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
检查是否生效:
which cargo
输出应该是 /root/.cargo/bin/cargo 或者 /home/你的用户名/.cargo/bin/cargo。
第四步:创建第一个 Rust 项目
现在来实际跑一个项目。用 Cargo 初始化:
cargo new hello-vps
cd hello-vps
Cargo 会自动生成项目结构和 Cargo.toml 配置文件。打开 src/main.rs 看看内容:
fn main() {
println!("Hello, VPS world!");
}
编译并运行:
cargo run
输出 Hello, VPS world! 就说明一切正常。
第五步:安装常用开发工具(可选)
如果你打算长期用 Rust 开发,建议装几个辅助工具:
# clippy - 代码静态检查
cargo install clippy
# rustfmt - 代码格式化
cargo install rustfmt
# cargo-edit - 方便管理依赖版本
cargo install cargo-edit
装完后可以试试格式化你的代码:
cargo fmt
第六步:设置自动更新
Rust 更新很频繁,建议定期更新保持最新版:
rustup update
如果想让它自动跑,加个 cron 任务:
crontab -e
添加这一行,每周日凌晨 3 点自动更新:
0 3 * * 0 rustup update 2>&1 | logger -t rustup-update
验证环境
完成以上步骤后,做最后检查:
# 检查 Rust 版本
rustc --version
# 检查 Cargo 版本
cargo --version
# 检查工具链信息
rustup show
# 检查项目能否正常构建
cargo build --release
rustup show 的输出会列出已安装的 toolchain、目标平台和激活的组件。确认 default 工具链显示为你的版本即可。
cargo build --release 会编译优化后的发布版本,输出在 target/release/ 目录下。
常见问题
Q: 安装时提示 curl 命令找不到?
先装 curl:sudo apt install -y curl
Q: cargo 命令找不到?
说明环境变量没生效。运行 source ~/.cargo/env,然后检查 ~/.bashrc 里有没有这行:
export PATH="$HOME/.cargo/bin:$PATH"
Q: 编译时报 OpenSSL 错误?
缺依赖。运行:sudo apt install -y libssl-dev pkg-config
Q: 磁盘空间不够了怎么办?
清理编译缓存:cargo clean。Rust 编译产物确实比较占空间,定期清理是个好习惯。
Q: 想切换 Rust 版本?
rustup install 1.75.0
rustup default 1.75.0
用 rustup show 查看所有已安装的版本。
Rust 的学习曲线比 Python 陡峭一些,但编译环境的搭建其实很简单。一条 curl 命令就能装好全套工具链,剩下的就是写代码了。
你的 VPS 准备好写 Rust 了吗?