VS Code格式化配置优先级为工作区设置＞用户设置，需在.vscode/settings.json中正确设置editor.defaultFormatter扩展ID，并按语言模式映射，确保.gitignore未忽略该文件。
格式化配置写在哪？用户设置和工作区设置谁说了算
VS Code 的格式化行为由 editor.formatOnSave、editor.defaultFormatter 等配置控制，但它们可能出现在两个地方：全局的「用户设置」和项目根目录下的「工作区设置」（.vscode/settings.json）。优先级是：工作区设置 > 用户设置。只要工作区里写了某条格式化相关配置，它就直接生效，用户设置里同名项完全被忽略。
- 常见错误现象：
editor.formatOnSave在用户设置里设为true，但保存时没格式化——大概率是工作区设置里写了"editor.formatOnSave": false，或者压根没配editor.defaultFormatter - 使用场景：团队项目需要统一用 Prettier 而不是 ESLint 自带的格式化器，就在
.vscode/settings.json里固定editor.defaultFormatter，避免成员各自在用户设置里乱配 - 注意路径差异：工作区设置只在打开该文件夹（或其子目录）时生效；如果用 VS Code 打开的是单个文件而非文件夹，工作区设置根本不会加载
格式化器选不中？editor.defaultFormatter 必须匹配已安装扩展的 ID
设了 editor.defaultFormatter 却没反应，不是配置没生效，而是值填错了。它必须填扩展在 Marketplace 上注册的唯一 ID，不是名字，也不是包名。比如 Prettier 官方扩展 ID 是 esbenp.prettier-vscode，而不是 prettier 或 prettier-vscode。
- 查法最稳：打开扩展面板，找到对应扩展，点右下角「Details」，看「Identifier」字段
- 常见错误：TypeScript 项目想用 ESLint 格式化，填了
dbaeumer.vscode-eslint—— 这扩展本身不提供格式化能力，得配合eslint.format.enable: true和eslint.options等额外配置，且仅对.js/.ts文件生效 - 语言特异性：同一格式化器可能需按语言单独指定，例如
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }，这种写法优先级高于顶层的editor.defaultFormatter
保存时格式化失效？检查 editor.formatOnSave 和文件关联是否匹配
editor.formatOnSave 默认是 false，即使装了格式化器也不会自动触发。但它只是开关，真正起作用还得看当前文件的语言模式（language mode）是否被格式化器支持。
- 常见错误现象：.vue 文件保存不格式化，但 .js 可以——Vue 单文件组件默认语言模式是
vue，而很多格式化器（如 Prettier）默认只认javascript、typescript、html；需手动加语言映射："[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 性能影响：开启
editor.formatOnSave后，大文件（>1MB）或低配机器上可能明显卡顿；可加限制："editor.formatOnSaveTimeout": 750（毫秒），超时就跳过 - 兼容性注意：某些格式化器（如
HookyQR.beautify）已停止维护，VS Code 1.80+ 会拒绝加载，此时设置仍存在但实际无效，控制台报错Extension 'HookyQR.beautify' is not compatible with VS Code
多人协作时工作区设置被忽略？Git 忽略 .vscode/ 是主因
团队约定好所有人在 .vscode/settings.json 里配了 Prettier，但新人 clone 项目后发现没生效——八成是 .vscode/ 目录被 .gitignore 屏蔽了。VS Code 不会自动创建或同步这个目录，全靠手动提交。
- 检查方法：终端执行
ls -a | grep vsco，确认.vscode/是否存在；再看git status里有没有.vscode/settings.json - 正确做法：把
.vscode/settings.json加进 Git，但排除.vscode/extensions.json和.vscode/workspaceStorage/这类个人状态文件 - 容易被忽略的点：Windows 用户用 VS Code Remote-SSH 连服务器时，工作区设置是在远程机器上读取的，本地
.vscode/完全无效；此时必须在远程项目的路径下有对应设置
