Rust开发环境搭建

1. Rust 环境准备

在 PowerShell 中设置 Rust 及 Cargo 的 HOME 环境变量(用户权限):

[System.Environment]::SetEnvironmentVariable("CARGO_HOME", "E:\dev_libs\rust\.cargo", "User")
[System.Environment]::SetEnvironmentVariable("RUSTUP_HOME", "E:\dev_libs\rust\.rustup", "User")

在 PowerShell 中设置 rustup 的工具链的国内镜像源(作用于 rustup install ...):

[System.Environment]::SetEnvironmentVariable("RUSTUP_DIST_SERVER", "https://mirrors.ustc.edu.cn/rust-static", "User")
[System.Environment]::SetEnvironmentVariable("RUSTUP_UPDATE_ROOT", "https://mirrors.ustc.edu.cn/rust-static/rustup", "User")

在CARGO_HOME目录下创建config.toml文件,配置 Cargo 的国内镜像源:

# cargo 链路:预定义 + 手动换 replace-with
[source.ustc-sparse]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

[source.crates-io]
replace-with = 'ustc-sparse'   # 想换回来就改回 'rsproxy-sparse'

2. 安装 Rust 工具链

从Rust 官方安装页面下载 rustup-init.exe,并在 PowerShell 中运行;由于已经设置好了 Rust 和 Cargo 的 HOME 环境变量,安装程序会自动安装到这些目录。在 rustup 提示中,只需要选择 1) Proceed with standard installation 即可。

rustup 常用命令:

# 更新 Rust 到最新稳定版
rustup update

# 查看已安装的工具链
rustup toolchain list

# 切换工具链(例如切换到 nightly 版)
rustup default nightly

# 卸载 Rust
rustup self uninstall

3. Cargo 的使用

3.1 创建一个新项目

cargo new my_project
cd my_project

# 构建项目
cargo build

# 运行项目
cargo run

3.2 常用 Cargo 命令

# 项目创建与管理
cargo new project_name          # 创建新的二进制项目
cargo new --lib project_name    # 创建新的库项目
cargo init                     # 在当前目录初始化项目
cargo install crate_name       # 安装二进制 crate
cargo uninstall crate_name     # 卸载二进制 crate

# 构建与编译
cargo build                    # 调试构建
cargo build --release          # 发布构建(优化)
cargo check                    # 快速检查编译错误(不生成可执行文件)
cargo clean                    # 清理构建产物
cargo build --verbose          # 显示详细构建信息

# 运行与测试
cargo run                      # 运行项目
cargo run --release            # 以发布模式运行
cargo run -- args              # 带参数运行
cargo test                     # 运行所有测试
cargo test test_name           # 运行特定测试
cargo test -- --nocapture      # 显示测试中的打印输出
cargo test --lib               # 只运行库测试
cargo test --doc               # 运行文档测试
cargo bench                    # 运行性能基准测试

# 代码质量
cargo fmt                      # 格式化代码(需要安装 rustfmt)
cargo fmt -- --check           # 检查代码格式(不修改)
cargo clippy                   # 代码 lint 检查
cargo clippy -- -D warnings    # 严格模式:将所有警告视为错误
cargo clippy --fix             # 自动修复可修复的问题
cargo audit                    # 检查安全漏洞(需要安装 cargo-audit)

# 依赖管理
cargo update                   # 更新 Cargo.lock 中的依赖版本
cargo update package_name      # 更新特定包
cargo tree                     # 显示依赖树
cargo tree --depth 1           # 显示一级依赖
cargo tree -i package_name     # 显示特定包的被依赖关系
cargo outdated                 # 检查过时的依赖(需要安装 cargo-outdated)

# 文档
cargo doc                      # 生成文档
cargo doc --open               # 生成并打开文档
cargo doc --no-deps            # 仅生成当前项目的文档
cargo rustdoc -- --help        # 查看 rustdoc 选项

# 发布与分发
cargo publish                  # 发布到 crates.io
cargo package                  # 创建发布包
cargo login API_TOKEN          # 登录 crates.io

# 工作区命令
cargo workspace                # 工作区管理(需要安装 cargo-workspace)
cargo members                  # 列出工作区成员

# 配置与信息
cargo version                  # 查看 Cargo 版本
cargo --list                   # 列出所有 Cargo 命令
cargo metadata                 # 以 JSON 格式输出项目元数据
cargo locate-project           # 输出 Cargo.toml 路径

A. 资源




Enjoy Reading This Article?

Here are some more articles you might like to read next: