rust-analyzer 是 rust 文件格式化的唯一有效入口，需安装该扩展并配置 "editor.defaultformatter": "rust-lang.rust-analyzer"，确保 rustfmt 可执行且路径正确，参数须写在 "rust-analyzer.rustfmt.extraargs" 下，工作区设置优先级高于全局，文件语言模式必须为 rust。
rust-analyzer 是格式化入口，不是 rust-lang.rust
VSCode 里真正调用 rustfmt 的是 rust-analyzer 扩展，不是旧版的 rust-lang.rust。如果你在 settings.json 里写了 "[rust]": { "editor.defaultFormatter": "rust-lang.rust" }，保存时会静默失败——因为该扩展已弃用，不再维护，也不再集成 rustfmt。
正确做法是：安装并启用 rust-analyzer（官方推荐），然后明确指定它为 Rust 文件的默认格式化器：
"[rust]": { "editor.defaultFormatter": "rust-lang.rust-analyzer" }- 确保
"editor.formatOnSave": true已启用（全局或工作区） - 不要混用
rust-lang.rust和rust-lang.rust-analyzer，二者冲突
rustfmt 必须可执行，PATH 或显式路径都得对
rust-analyzer 默认通过系统 PATH 查找 rustfmt。如果它找不到，保存时不会报错，只会跳过格式化——你看到的“没反应”，大概率是这个原因。
检查方式很简单，在终端运行：
rustfmt --version
如果报 command not found，说明 rustfmt 没装或不在 PATH 中。用 rustup 安装即可：
rustup component add rustfmt
若仍不行（比如用了自定义 toolchain 或多版本管理），可在设置中显式指定路径：
-
"rust-analyzer.rustfmt.path": "/home/you/.rustup/toolchains/stable-x86_64-unknown-linux-gnu/bin/rustfmt"（Linux/macOS） -
"rust-analyzer.rustfmt.path": "C:\Users\You\.rustup\toolchains\stable-x86_64-pc-windows-msvc\bin\rustfmt.exe"（Windows） - 注意路径里不能有空格或中文，否则
rust-analyzer可能启动失败
extraArgs 配置写在 rust-analyzer 下，不是 rust
想传参给 rustfmt（比如指定 edition 或启用 verbose 日志），必须写在 rust-analyzer 的命名空间下，而不是 rust 或 rust-lang.rust。
常见错误写法："rust.rustfmt.extraArgs" —— 这个键根本不存在，会被忽略。
正确配置示例：
"rust-analyzer.rustfmt.extraArgs": ["--edition", "2021"]-
"rust-analyzer.rustfmt.extraArgs": ["--unstable-features", "--skip-children"]（慎用，部分参数需 nightly rustfmt） - 参数顺序不重要，但每个 flag 和值要分开成独立字符串项
加了 --verbose 后，格式化失败时会在 VSCode 输出面板（Output → Rust Analyzer）里打印具体错误，比如 “failed to parse config file” 或 “edition mismatch”，比静默失败好排查得多。
工作区设置优先级高，.vscode/settings.json 容易覆盖全局
很多人配好了全局 settings.json，却发现某个项目里保存不格式化——八成是项目根目录下有 .vscode/settings.json，里面写了 "editor.formatOnSave": false 或漏掉了 "[rust]" 配置。
VSCode 的设置优先级是：工作区 > 用户 > 默认。所以即使你全局开了 formatOnSave，只要工作区显式关了，它就无效。
建议操作：
- 打开命令面板（
Ctrl+Shift+P），输入Preferences: Open Workspace Settings (JSON)，检查是否被覆盖 - 如果团队协作，把必要配置（如
"[rust]"块和"editor.formatOnSave"）放进工作区.vscode/settings.json并提交到 Git - 避免在工作区里写
"editor.formatOnSave": true却不配"[rust]"，这样 Rust 文件仍不会格式化
真正容易被忽略的是：Rust 文件类型识别必须准确。如果文件后缀是 .rs 但 VSCode 右下角显示的是 “Plain Text” 而非 “Rust”，那所有格式化配置都白搭——先点右下角语言模式，选 “Rust” 手动切换一次，后续同名文件才会自动识别。
