rustfmt

Rust 代码格式化工具

补充说明

rustfmt 按官方风格格式化 Rust 源码，通常通过 cargo fmt 调用。它只处理格式，不修复逻辑或 lint 问题。

常用示例

rustup component add rustfmt
cargo fmt
cargo fmt -- --check
rustfmt src/main.rs
rustfmt --edition 2021 src/lib.rs
rustfmt --check src/main.rs

rustfmt.toml：

edition = "2021"
max_width = 100
imports_granularity = "Crate"

易错点与排错

• CI 用 cargo fmt -- --check；只跑 cargo fmt 会静默改文件，无法当门禁。
• 格式化会制造大 diff；最好单独提交，避免和逻辑改动混在一起。
• 部分配置项只在 nightly 可用；stable 上会被忽略或报错。
• #[rustfmt::skip] 可以跳过局部代码，但不要用它掩盖格式冲突。
• 生成代码是否格式化要统一；否则每次生成都会产生 diff。
• rustfmt 版本变化可能改变输出；CI 固定工具链。
• 格式化不解决命名、复杂度和安全问题；别把它当质量检查。

相关命令

• cargo — 构建与测试
• clippy — 静态检查
• rustup — 安装组件