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. 资源
- Rust 官方包仓库:
crates.io提供的包仓库 - Rust 包检索平台:
lib.rs提供的包检索平台,有更好的搜索界面 - Rust 官方文档
- Rust 编程语言书籍
- Rust 程序设计语言:
The Rust Programming Language中文翻译版
Enjoy Reading This Article?
Here are some more articles you might like to read next: