VSCode 的 .vscode 目录仅通过 settings.json、tasks.json、launch.json 文件实现共享配置，extensions.json 仅提示安装插件；须锁定 tabSize、insertSpaces 等关键格式化设置，禁用干扰项，避免硬编码路径和误配 files.exclude；生效需确保以根目录为工作区打开、设置显示“Workspace”优先级、重启窗口，并装妥对应插件。
团队里 VSCode 配置不一致，会导致格式化结果不同、代码提交带多余空格、甚至 ESLint 报错位置偏移——.vscode 目录确实能统一，但直接放进去就生效？不是。
哪些配置能被 .vscode 目录真正共享
只有明确写进 .vscode/settings.json、.vscode/tasks.json、.vscode/launch.json 的内容才会被 Git 跟踪并同步。用户级设置（比如字体大小、主题）不会、也不该放进这里。
-
settings.json：控制格式化工具路径、缩进、保存时自动修复等，对协作影响最大 -
tasks.json：定义npm run build这类命令的快捷执行方式，避免每人手动敲 -
launch.json：仅当项目有调试需求（如 Node.js 启动参数、端口）才需要，否则别加 -
extensions.json：可建议团队安装哪些插件，但不会自动安装，且部分插件（如 Prettier）必须配合settings.json才生效
settings.json 里哪些键必须锁定，哪些要谨慎覆盖
统一配置不是“全盘接管”，有些设置强行写死会反向破坏本地开发体验（比如你用 macOS，同事用 Windows，terminal.integrated.defaultProfile 就不能硬编码）。
- 必须锁定：
"editor.tabSize"、"editor.insertSpaces"、"editor.formatOnSave"、"editor.codeActionsOnSave"（尤其"source.fixAll.eslint"） - 建议用
null显式禁用：如"editor.suggest.snippetsPreventQuickSuggestions"，避免插件默认行为干扰 - 禁止硬编码路径：
"eslint.runtime"或"prettier.prettierPath"应设为./node_modules/.bin/prettier，而不是/Users/xxx/... - 慎用
"files.exclude"：它会影响全局文件树展示，容易误藏关键文件（如.env.local），优先用.gitignore
为什么同事拉了代码还是没生效？常见断点排查
配置进了 .vscode 不等于立刻起效，VSCode 有缓存和作用域优先级规则。
- 确认工作区已打开根目录：VSCode 必须以包含
.vscode的文件夹为“工作区”打开，而不是只打开某个子文件 - 检查设置覆盖链：按
Cmd+,（macOS）或Ctrl+,（Windows/Linux），搜索某项设置，看右侧是否显示“Workspace”图标；若显示“User”或“Remote”，说明被更高优先级覆盖 - 重启窗口：改完
settings.json后，执行Developer: Reload Window命令，而非仅关闭再开 - 插件未启用：如果
settings.json里启用了eslint.enable，但机器没装 ESLint 插件，该设置无效且无提示
最易被忽略的是：VSCode 的“工作区推荐扩展”（extensions.json）只在首次打开时弹窗提示，之后不再提醒；而格式化逻辑依赖插件 + 设置双重就位，缺一不可。
