全部文章

编程语言

Rust 安装与入门

Rust 编程语言的安装配置、Cargo 工具链与 VS Code 开发环境

2026年2月3日
编程语言

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 配置

推荐扩展：

扩展说明
rust-analyzer语言服务器
Even Better TOMLTOML 文件支持
CodeLLDB调试器

配置国内镜像

创建或编辑 ~/.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 是否写对
  • 镜像源是否仍可用
  • 是否需要切回官方源排查

延伸阅读

参考链接

相关文章