Rust 风格格式化与静态分析技能 — rustfmt 配置（缩进、换行、导入组织）、Clippy lint 体系（allow/warn/deny、clippy.toml、关键 lint 群组）、Edition 迁移指南（2015→2018→2021→2024，cargo fix --edition）、编译器错误码解读（rustc --explain、常见 E0277/E0308/E0502/E0597/E0432）。基于 rustfmt Book、Clippy Book、Edition Guide、Error Code Index。当用户需要格式化代码、运行静态分析、迁移 edition 或解读编译器错误时激活。
基于 rustfmt Book、Clippy Book、Edition Guide 与 Error Code Index.
rust-1.93 技能rust-code-review 技能本技能不收集、存储或传输任何用户数据。
# .rustfmt.toml
max_width = 100 # 行宽（默认 100）
tab_spaces = 4 # 缩进空格
edition = "2024" # Rust edition
fn_args_layout = "Tall" # 参数布局
imports_granularity = "Module" # 导入粒度
imports_layout = "Horizontal" # 导入布局
merge_derives = true # 合并 derive
use_field_init_shorthand = true # 字段初始化简写
reorder_impl_items = true # 重排 impl 项
cargo fmt # 格式化所有文件
cargo fmt --check # 检查格式（CI 使用）
cargo fmt -- --config max_width=80 # 使用特定配置
cargo clippy # 运行所有 lint
cargo clippy -- -W clippy::pedantic # 启用额外 lint 群组
cargo clippy --fix # 自动修复
// 控制 lint 级别
#[allow(clippy::needless_return)]
fn my_fn() { return 42; }
#[deny(clippy::unwrap_used)]
fn safe_fn() -> Result<i32, Error> {
let v = risky()?; // 不能用 unwrap
Ok(v)
}
// clippy.toml（项目根目录）
// disallowed-macros = ["unwrap", "expect"]
// cognitive-complexity-threshold = 25
关键 lint 群组：
| 群组 | 说明 | 常用 lint |
|------|------|-----------|
| correctness | 编译正确性（默认） | clippy::almost_swap |
| style | 代码风格（默认） | clippy::enum_variant_names |
| complexity | 复杂度提示 | clippy::too_many_arguments |
| perf | 性能提示 | clippy::large_enum_variant |
| pedantic | 严格模式（需主动启用） | clippy::cast_possible_truncation |
| nursery | 实验性 | clippy::use_self |
| restriction | 限制性最强 | clippy::unwrap_used, clippy::expect_used |
# 查看当前 edition
cargo metadata --format-version 1 | jq '.packages[0].edition'
# 迁移步骤（以 2021 → 2024 为例）
cargo fix --edition # 自动迁移代码
cargo build # 检查编译
cargo test # 验证功能
# 更新 Cargo.toml
# edition = "2024"
各 edition 关键变化：
| Edition | 关键变化 |
|---------|---------|
| 2015→2018 | NLL 借用检查、模块系统（不再 extern crate + mod.rs → name.rs）、trait 默认导入、union 改进 |
| 2018→2021 | 闭包捕获改进（|| 仅捕获需要的字段）、IntoIterator for 数组、panic 宏一致化、Cargo.toml [workspace] 继承 |
| 2021→2024 | 默认类型推断改进、impl Trait 位置更灵活、unsafe 块可包含更多模式、assert!(expr) 消息改进、unsafe_op_in_unsafe_fn 默认 warn |
# 查看错误详情
rustc --explain E0277
| 错误码 | 含义 | 典型场景 |
|--------|------|---------|
| E0277 | trait 未实现 | T: Trait bound 不满足 |
| E0308 | 类型不匹配 | 期望类型 A，但给了 B |
| E0502 | 借用冲突 | 不能可变借用 + 不可变借用 simultaneously |
| E0597 | 生命周期不足 | 引用超出借用值的作用域 |
| E0432 | 导入不存在 | use 路径有误 |
| E0061 | 参数数量不匹配 | 函数调用参数数错误 |
| E0106 | 生命周期缺失 | 函数签名需要显式生命周期 |
| E0382 | 使用已移动值 | 所有权已转移 |
| E0499 | 同时可变借用 | 只能一个 &mut |
| E0716 | 临时值生命周期不足 | 临时值的引用超出其作用域 |