VSCode保存时格式化失效，主因是格式化链路中断：语言模式错配、defaultFormatter未绑定、工作区配置覆盖、Prettier配置文件语法错误或插件未启用。

VSCode 未保存文件格式化失效，跟系统权限无关——它压根不涉及文件写入操作，所以 chmod、管理员运行、UAC 提权全都不解决问题。

editor.formatOnSave 失效时，“未保存”只是表象；真正卡住的是格式化器没被调用，或调用后没返回结果。

---

formatOnSave 开启了但没反应，先查配置覆盖

VSCode 的格式化开关是分层生效的：用户级 → 工作区级 → 语言专属级，低优先级设置会被高优先级静默覆盖。

• 打开命令面板（Ctrl+Shift+P），执行 Preferences: Open Workspace Settings (JSON)，检查是否存在：

  "[javascript]": { "editor.formatOnSave": false }

  或

  "editor.formatOnSave": false

• 同样检查用户级设置（Preferences: Open User Settings (JSON)），确认 editor.formatOnSave 是 true，且没被注释掉
• 右下角点击当前语言模式（如 JavaScript），再点齿轮图标 → “Configure JavaScript language-specific settings”，看里面是否关掉了格式化

---

右下角显示 Plain Text 或 None，说明语言模式错配

格式化只对匹配语言 ID 的文件触发。如果 .ts 文件被识别为 JavaScript，vscode.typescript-language-features 就不会启动；如果 .vue 文件是 HTML，Volar 和 Prettier 插件也不会介入。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 按 Ctrl+Shift+P → 输入 Change Language Mode → 手动选对语言（如 Vue、TypeScript React）
• 在 settings.json 中显式绑定后缀：

  "files.associations": { "*.vue": "vue", "*.tsx": "typescriptreact" }

• 错配时右下角显示 Plain Text 或 None，此时 formatOnSave 直接不触发

---

Format Document With… 列表为空，说明格式化器没注册成功

VSCode 不会自动把已安装插件设为默认格式化器。必须明确指定语言对应的 editor.defaultFormatter。

• 打开设置（Ctrl+,），搜 default formatter，展开对应语言项（如 JavaScript › Default Formatter），下拉选择 esbenp.prettier-vscode（注意拼写，不能少字母或多空格）
• HTML / Vue / Markdown 等非标准语言需在 settings.json 中手动加块：

  "[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }

• 运行 Format Document With…，如果列表为空，说明插件未启用、版本不兼容，或配置里写了错误 ID（比如写成 prettier 而非 esbenp.prettier-vscode）

---

Prettier 配置文件语法错误导致静默退出

prettier.config.js 或 .prettierrc 里一个尾随逗号、单引号、JS 注释，就会让 Prettier 解析失败——它不报错，直接放弃加载规则，退回到“不格式化”状态。

• 检查 .prettierrc 是否是合法 JSON（不能有注释、单引号、尾随逗号）
• 改用 prettier.config.js 更稳妥，内容至少含：

  module.exports = { semi: true, singleQuote: true };

• 对 HTML 文件，还需在配置中加 plugins: ['prettier-plugin-html']，否则 Prettier 默认跳过

真正的难点不在“怎么开权限”，而在于 VSCode 格式化是一条链路：语言识别 → 格式化器注册 → defaultFormatter 绑定 → 配置文件加载 → CLI 可执行。任一环断开，都会表现为“没反应”，但原因各不相同。