Rust 安装与入门

Rust 是注重安全性和性能的系统编程语言。

这页适合做“Rust 工具链安装到第一批工程习惯”的起步说明。Rust 的学习门槛很多时候不在安装，而在于你要尽早熟悉 rustup、cargo、格式化、lint 和依赖管理这一整套开发流。

推荐上手顺序

建议按下面顺序开始：

1. 先装好 rustup 和稳定版工具链
2. 用 cargo new 跑通第一个项目
3. 熟悉 cargo check、cargo run、cargo test
4. 再补 cargo fmt、cargo clippy 和常用扩展工具

先把工程体验跑顺，再去啃所有语法和所有权模型，会更不容易劝退。

安装 Rustup

Rustup 是 Rust 的官方安装器和版本管理工具。

winget install Rustlang.Rustup

或从官网下载：rustup.rs

验证：

rustc --version
cargo --version

Cargo 常用命令

# 创建项目
cargo new my-project
cargo new --lib my-lib

# 编译与运行
cargo build              # 调试构建
cargo build --release    # 发布构建
cargo run                # 编译并运行
cargo check              # 快速检查（不生成二进制）

# 测试与质量
cargo test               # 运行测试
cargo fmt                # 格式化代码
cargo clippy             # 代码检查（lint）

VS Code 配置

推荐扩展：

配置国内镜像

创建或编辑 ~/.cargo/config.toml：

[source.crates-io]
replace-with = "ustc"

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

实用工具

# cargo-watch：文件变更自动运行
cargo install cargo-watch
cargo watch -x run

# cargo-edit：命令行管理依赖
cargo install cargo-edit
cargo add serde
cargo add tokio --features full

# cargo-expand：展开宏
cargo install cargo-expand

常见目录和文件

一个最小 Rust 项目通常会看到：

my-project/
  Cargo.toml
  Cargo.lock
  src/
    main.rs

可以简单理解为：

• Cargo.toml：项目配置和依赖
• Cargo.lock：精确依赖锁定
• src/main.rs：二进制项目入口

如果是库项目，则通常会看到 src/lib.rs。

进阶：交叉编译

# 添加目标平台
rustup target add x86_64-unknown-linux-gnu

# 交叉编译
cargo build --target x86_64-unknown-linux-gnu --release

常见问题

安装完后命令找不到

优先检查：

• 终端是否重开
• cargo、rustc 是否已加入 PATH
• 当前 shell 是否加载了最新环境变量

编译很慢

Rust 首次编译和依赖多的项目确实会慢一些。日常开发时优先使用：

• cargo check
• cargo run
• cargo test

只有要发布或看最终性能时，再跑 --release。

镜像源配置后依赖异常

如果用了国内镜像，出现拉取异常时，要确认：

• ~/.cargo/config.toml 是否写对
• 镜像源是否仍可用
• 是否需要切回官方源排查

延伸阅读

• VS Code 配置指南
• GitHub Actions 入门
• Docker Desktop 安装与使用

参考链接

• Rust 官网 — 中文页面
• Rust GitHub — 源码
• The Rust Book 中文版 — 官方教程
• Rustup 文档 — 工具链管理
• crates.io — Rust 包注册中心
• USTC 镜像 — 中科大镜像说明