Rust开发环境从零搭建：Cargo+Rustup+Cargo Tools完整指南

概述

Rust 这几年越来越火，系统编程、WebAssembly、CLI工具都能看到它的身影。但很多新手卡在第一步——装环境。

网上教程要么是 apt install rustc（版本太老），要么是手动下载压缩包（麻烦）。正确做法是用官方工具 rustup，一键安装完整工具链，还能随时切换版本。

这篇教程带你从0开始，装好 rustup、配置环境变量、安装常用 Cargo 插件，最后验证环境是否正常工作。

准备工作

你需要满足以下条件：

  • 一台 Linux 服务器或本地机器（Ubuntu 20.04+、Debian 11+、CentOS 8+ 均可）
  • root 权限或 sudo 权限
  • 能访问外网（下载 rustup-init 需要）
  • 磁盘剩余空间至少 500MB（完整工具链约 300MB）

Windows 和 macOS 用户同样适用，只是安装命令略有不同，文末会提。

步骤

第一步：安装 rustup（Rust 版本管理器）

rustup 是 Rust 官方提供的工具链管理器。它负责下载、安装、切换不同版本的 Rust 编译器。

运行这条命令：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装过程中会问你几个问题：

  1. 选择安装方式——输入 1（默认安装，推荐）
  2. 是否安装 nightly 工具链——输入 n（先用 stable 版）
  3. 是否修改 PATH——输入 1（让它帮你改）

安装完成后，你会看到类似这样的输出：

Rust is installed now. Great!

To configure your current shell, you need to source
the corresponding env file under /home/你的用户/.cargo/env.

This can be done by running the following in your shell:

source "$HOME/.cargo/env"

第二步：刷新环境变量

新装的 rustup 需要重新加载 shell 配置才能生效。执行：

source "$HOME/.cargo/env"

或者重启终端/SSH 会话。

验证安装：

rustc --version
cargo --version
rustup --version

输出应该类似：

rustc 1.79.0 (129f3b9bd 2024-06-01)
cargo 1.79.0 (ffa9cf99a 2024-06-01)
rustup 1.27.1 (704b58ec9 2024-05-28)

如果这三个命令都能正常输出，说明工具链装好了。

第三步：配置国内镜像（可选，中国大陆用户）

默认情况下，cargo 会从 crates.io 下载依赖包。国内网络可能会慢甚至超时。

创建一个配置文件 ~/.cargo/config.toml：

mkdir -p ~/.cargo
cat << 'EOF' > ~/.cargo/config.toml
[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"
EOF

这样就换成了中国科学技术大学的镜像源。拉取依赖会快很多。

第四步：安装常用 Cargo 工具

Cargo 是 Rust 的包管理器和构建工具。除了基础命令，还有很多实用的插件工具。

一次性装好常用的：

cargo install \
  cargo-audit \
  cargo-clippy \
  cargo-edit \
  cargo-outdated \
  cargo-sort \
  cargo-watch

这些工具分别是：

  • cargo-audit：安全审计，检查依赖有没有已知漏洞
  • cargo-clippy：代码风格检查，帮你写更规范的 Rust 代码
  • cargo-edit：命令行管理依赖，不用手动改 Cargo.toml
  • cargo-outdated：查看哪些依赖可以升级
  • cargo-sort：自动排序 Cargo.toml 里的依赖列表
  • cargo-watch：文件改动时自动重新编译，开发时很好用

每个工具装完都能直接跑，比如：

cargo clippy --version
cargo audit --version

第五步：安装开发辅助工具

除了 Cargo 插件，还有几个常用的 Rust 开发工具：

# rust-analyzer（IDE 智能补全核心）
cargo install rust-analyzer

# rustfmt（代码格式化）
rustup component add rustfmt

# rust-src（源码查看，支持 IDE 跳转到标准库）
rustup component add rust-src

验证安装：

rust-analyzer --version
rustfmt --version

第六步（可选）：配置 IDE

如果你用 VS Code，装这两个扩展：

  1. rust-analyzer（必装）
  2. Error Lens（可选，把错误信息直接显示在代码行上）

装完重启 VS Code，打开任何 Rust 项目，rust-analyzer 会自动索引代码，提供补全、跳转、重构等功能。

如果你用 JetBrains 的 RustRover，开箱即用，不用额外配置。

验证

所有步骤完成后，跑这几个检查：

# 1. 工具链版本
rustc --version
cargo --version

# 2. 组件是否齐全
rustup component list --installed

# 3. 常用工具是否可用
cargo clippy --version
cargo audit --version
cargo edit --version
cargo outdated --version
rustfmt --version
rust-analyzer --version

# 4. 创建一个小项目测试
cargo new test-rust-env
cd test-rust-env
cargo run

cargo run 应该输出：

Hello, world!

五个检查都通过，环境就彻底搞定了。

常见问题

装完 rustup 后命令找不到？

没刷新环境变量。执行 source "$HOME/.cargo/env" 或重新登录 SSH。

cargo install 报错 “timeout” 或 “connection refused”？

换镜像源。参考第三步的配置，换成 ustc 或清华镜像。

rust-analyzer 在 VS Code 里报 “rust-analyzer not found”？

检查 PATH 是否包含 ~/.cargo/bin。运行 echo $PATH 看看有没有这个路径。如果没有，编辑 ~/.bashrc 加一行：

export PATH="$HOME/.cargo/bin:$PATH"

然后 source ~/.bashrc。

Windows 用户怎么装？

去 rustup.rs 下载 rustup-init.exe，双击运行，后续步骤和 Linux 差不多。

macOS 用户呢？

macOS 建议先装 Homebrew，然后：

brew install rustup
rustup-init

怎么切换 Rust 版本？

用 rustup：

# 切换稳定版
rustup default stable

# 切换 nightly
rustup default nightly

# 安装特定版本
rustup toolchain install 1.75.0
rustup default 1.75.0

卸载 Rust 怎么办？

rustup self uninstall

Rust 环境搭建说难不难，但步骤多一点容易漏。用 rustup 管理工具链是最省事的做法，以后升级、切换版本都一条命令搞定。

装完跑一下 cargo new hello && cd hello && cargo run，看到 Hello, world! 就算入门了。你打算用 Rust 写点什么？

这篇文章对你有帮助吗？