VSCode团队协作配置真正起效的关键在于.vscode/settings.json中必须锁定editor.tabSize、editor.insertSpaces、editor.formatOnSave、editor.defaultFormatter及editor.codeActionsOnSave中的"source.fixAll.eslint"等核心字段，且路径类配置须用相对路径、禁用硬编码，生效需确认工作区打开、设置显示“Workspace”优先级并执行Developer: Reload Window。
VSCode 团队协作配置真正起效的关键，不在装多少插件，而在 .vscode/settings.json 里是否锁定了那几个影响格式化一致性的核心字段。 其他设置哪怕全对，只要 editor.tabSize、editor.insertSpaces 或 editor.formatOnSave 没统一，团队成员保存同一份 JS 文件就可能触发 20 行 diff —— 全是空格和缩进差异。
哪些 settings.json 字段必须显式写死？
这些键值一旦缺失或被用户级设置覆盖，就会导致“同一项目、不同人格式化结果不一致”。它们不是可选项，而是协作底线：
-
editor.tabSize：必须设为数字（如2或4），不能留空或依赖插件默认 -
editor.insertSpaces：必须设为true（禁用制表符）或false（启用制表符），严禁不写 -
editor.formatOnSave：必须设为true，否则 Prettier/ESLint 的自动修复永远不触发 -
editor.defaultFormatter：必须指定具体扩展 ID，例如"esbenp.prettier-vscode"，不能只装插件却不声明 -
editor.codeActionsOnSave中的"source.fixAll.eslint"：若项目用 ESLint，这项要明确开启，否则保存时不修复 lint 错误
哪些路径类配置绝对不能硬编码？
硬编码本地绝对路径会让配置在同事机器上直接失效，甚至引发 Command failed: /Users/xxx/node_modules/.bin/prettier 这类错误。
-
prettier.prettierPath应设为"./node_modules/.bin/prettier"（相对路径） -
eslint.runtime同理，用"./node_modules/node"而非/usr/local/bin/node -
typescript.preferences.includePackageJsonAutoImports等语言服务配置，不要指向全局node_modules -
files.exclude和search.exclude尽量避免写具体路径，改用通配模式如"**/dist"；尤其别加.env.local这类本该可见的文件
为什么改了 settings.json 还没生效？三步验证法
配置进了 .vscode/settings.json ≠ 自动生效。常见断点就卡在这三步：
- 确认 VS Code 是以该文件夹为「工作区」打开的——不是只打开某个子文件，而是菜单栏显示「Explorer」里根目录名旁有「Workspace」图标
- 按
Cmd+,（macOS）或Ctrl+,（Windows/Linux），搜editor.tabSize，右侧必须显示「Workspace」小图标；若显示「User」，说明被更高优先级覆盖了 - 执行
Developer: Reload Window命令（而非关再开），否则 JSON 解析缓存不刷新，改了也白改
最常被忽略的一点：.vscode 配置只管编辑器行为，不管 lint 规则本身。即使 editor.formatOnSave 开了，若项目没配 .prettierrc 或 .eslintrc.cjs，保存时照样不格式化——settings.json 是开关，规则文件才是子弹。
