VSCode保存时没反应大概率是rustfmt未被rust-analyzer调用：需安装启用rust-analyzer、设"[rust]": {"editor.defaultFormatter": "rust-lang.rust-analyzer"}、开启"editor.formatOnSave": true，并确保rustfmt在PATH中或显式配置路径，参数须写在"rust-analyzer.rustfmt.extraArgs"下。
VSCode 保存时没反应，大概率不是配置漏了，而是 rustfmt 根本没被调用起来——rust-analyzer 找不到它，也不会报错，只会静默跳过。
rust-analyzer 是唯一有效的格式化入口
旧版 rust-lang.rust 扩展已弃用，写成 "[rust]": { "editor.defaultFormatter": "rust-lang.rust" } 会导致保存自动格式化完全失效，且无任何提示。VS Code 实际调用 rustfmt 的路径只有一条：通过 rust-analyzer 启动。
- 必须安装并启用
rust-analyzer（官方推荐，Open VSX 或 VS Code Marketplace 均可） - 设置中明确指定：
"[rust]": { "editor.defaultFormatter": "rust-lang.rust-analyzer" } -
"editor.formatOnSave": true要全局或工作区级开启（建议放工作区.vscode/settings.json中，避免污染全局） - 不要同时配置
rust-lang.rust和rust-lang.rust-analyzer，二者冲突，后者会忽略前者
rustfmt 必须能被 rust-analyzer 找到
rust-analyzer 默认从系统 PATH 查找 rustfmt，找不到就放弃，不报错。你改完设置却没效果，90% 是这个原因。
- 终端执行
rustfmt --version，若提示command not found，说明未安装：rustup component add rustfmt - Windows 用户注意：MSVC 工具链下
rustfmt.exe在C:\Users\XXX\.rustup\toolchains\stable-x86_64-pc-windows-msvc\bin\rustfmt.exe；若用 GNU 工具链，路径后缀是-gnu - Linux/macOS 若用
rustup多 toolchain（如nightly），需显式指定路径："rust-analyzer.rustfmt.path": "/home/you/.rustup/toolchains/nightly-x86_64-unknown-linux-gnu/bin/rustfmt" - 路径中含空格或中文会导致启动失败（比如 OneDrive 同步目录），务必避开
参数和项目级规则必须写对位置
想传参给 rustfmt（比如指定 edition 或加 --verbose），键名必须严格为 rust-analyzer.rustfmt.extraArgs。写成 rust.rustfmt.extraArgs 或 rust-analyzer.rustfmt.args 都会被忽略。
- 参数要拆成独立字符串：
"rust-analyzer.rustfmt.extraArgs": ["--edition", "2021", "--unstable-features"] - 项目级配置优先于 VS Code 设置，把
.rustfmt.toml放在 Cargo 项目根目录即可生效 - 常见稳定项示例（放在
.rustfmt.toml中）：max_width = 100、edition = "2021"、use_small_heuristics = "Max" -
.rustfmt.toml不支持所有rustfmt --help参数，不稳定选项（如--skip-children）需 nightlyrustfmt且可能破坏格式一致性
cargo fmt 是验证和补救的底线手段
当 VS Code 自动格式化失灵，或者你想批量处理整个 workspace，cargo fmt 是最可靠 fallback。它不依赖编辑器，直接调用本地 rustfmt。
-
cargo fmt：格式化当前 crate 所有文件 -
cargo fmt -- src/main.rs：只格式化单个文件（路径相对项目根） -
cargo fmt -- --check：仅检查是否已格式化（CI 流水线必备，失败时返回非零退出码） - 如果
cargo fmt也报错，说明rustfmt本身异常（如版本不匹配、配置语法错误），此时 VS Code 必然无法工作
最容易被忽略的是路径问题：Windows 上反斜杠、空格、中文路径会让 rust-analyzer 启动 rustfmt 失败；而 .rustfmt.toml 文件名带错别字（比如 rustfmt.toml 少个点）或放错位置（不在 Cargo 项目根），也会导致规则不生效——这些地方没有日志，只能手动排查。
