VSCode代码格式规范强制执行与检查快捷键的自动化流转-VSCode-PHP中文网

vscode保存时代码无变化，根本原因是editor.formatonsave启用后缺少三硬性依赖：未安装对应语言格式化扩展、项目根目录缺失配置文件、未在项目根文件夹下打开工作区。

vscode代码格式规范强制执行与检查快捷键的自动化流转

VSCode 本身不执行代码风格检查，也不“强制”规范——它只转发请求给外部工具（如 ESLint、Prettier、Black）。所谓“自动化流转”，本质是：保存 → 触发格式化 → 同步调用 Linter 修复 → 应用结果。漏掉任一环，就会出现“保存了但没反应”或“波浪线还在”。

为什么保存后代码没变样？检查这三处硬性依赖

VSCode 的 editor.formatOnSave 不是魔法开关，它背后必须同时满足：

已安装对应语言的格式化扩展（如 esbenp.prettier-vscode），且未被禁用
项目根目录存在可识别的配置文件（.prettierrc、.eslintrc.cjs 或 pyproject.toml 中含 [tool.black]）
VSCode 当前打开的是**项目根文件夹**（不是某个子目录），否则插件找不到 node_modules 或 venv

常见错误现象：Format Document 命令灰掉、右下角语言标识旁没有格式化器图标、保存后缩进/引号/分号毫无变化。此时先运行 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools，看 Console 是否报 Failed to load module 类错误。

ESLint + Prettier 共存时，`source.fixAll.eslint` 和 `editor.formatOnSave` 怎么配才不打架？

二者职责不同：ESLint 检查逻辑问题（如 no-unused-vars），Prettier 只管样式（空格、换行、引号）。冲突发生在它们都试图改同一处（比如引号类型）时。正确做法是让 ESLint “让位”：

在 .eslintrc.cjs 的 extends 数组末尾加上 "plugin:prettier/recommended"（不是 prettier 单独一项）
在 settings.json 中禁用 ESLint 的格式类修复："editor.codeActionsOnSave": { "source.fixAll.eslint": true } —— 这句只修 ESLint 能自动修的逻辑问题，不碰格式
确保 "editor.defaultFormatter" 明确设为 "esbenp.prettier-vscode"，而非留空或设成 ESLint 插件

验证是否成功：改一行用双引号的字符串，保存后只触发一次格式化，且无红色波浪线提示 conflicting rule。

VSCode

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

下载

`Shift+Alt+F` 失效？优先排查语言模式和 formatter 绑定

这个快捷键实际调用的是当前文档语言模式（language mode）绑定的 formatter。失效常见于：

右下角显示的语言是 Plain Text 而非 JavaScript 或 Python（点击切换）
该语言未设置默认 formatter，例如 Python 文件没装 ms-python.black-formatter，又没在 settings.json 里写 "[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }
项目级 .vscode/settings.json 覆盖了用户级设置，但里面漏写了语言专属配置

快速诊断：按 Ctrl+Shift+P → 输入 Format Document With... → 看列表中是否有可用选项。若为空，说明当前语言没注册 formatter。

团队协作时，`.editorconfig` 和 `.vscode/settings.json` 该信谁？

.editorconfig 是跨编辑器通用层（WebStorm、Vim、VSCode 都认），控制缩进类型、大小、换行符等基础项；.vscode/settings.json 是 VSCode 专属层，决定用哪个 formatter、是否保存时触发。二者不冲突，但优先级不同：

.editorconfig 中的 indent_style 和 indent_size 会覆盖 settings.json 里的 editor.tabSize 和 editor.insertSpaces
settings.json 里的 editor.formatOnSave 仍生效，但 formatter 输出会尊重 .editorconfig 的缩进约定
关键点：.editorconfig 必须放在项目根目录，且文件首行需有 root = true，否则子目录下可能被忽略