最常见原因是工作区未被正确识别：必须通过“File→Open Folder…”打开含.vscode的项目根目录，若打开子目录或依赖“最近打开”缓存路径，则配置不加载；验证方式是搜索设置项，右侧显示“Workspace”图标才表示生效。
为什么 .vscode/settings.json 写了却没生效
最常见的情况是：配置文件存在，但 VSCode 没以“工作区”方式加载项目。VSCode 只有在打开的文件夹**包含 .vscode 目录且被识别为根工作区**时，才会读取 settings.json。如果只是双击某个子文件夹、或用“Open Folder”打开了嵌套目录（比如 ./packages/ui），那 .vscode 就在上级，完全不会触发。
验证方法：按 Ctrl+, 打开设置，搜 editor.tabSize，右侧若显示 “Workspace” 图标，说明已生效；若显示 “User” 或空白，说明没加载到。
- 必须用“File → Open Folder…” 选中项目最外层根目录（含
.vscode和package.json的那个） - 不要依赖“最近打开”，它可能缓存了旧路径
- 多人协作中，建议在 README 明确写：“请确保以本仓库根目录为工作区打开”
- Monorepo 场景下，
.vscode放在 monorepo 根，而非各 package 下
哪些 settings.json 配置项必须显式锁定
跨部门团队最难统一的是“看似无关紧要”的基础行为——比如缩进空格数、换行符、是否自动保存。这些不锁死，git diff 就会因空格/换行差异满屏红。
-
"editor.tabSize": 2：强制 2 空格，禁用制表符（"editor.insertSpaces": true必配） -
"files.eol": "\n"：统一 LF，避免 Windows 用户提交 CRLF 导致 CI 失败 -
"editor.formatOnSave": true：格式化必须自动，不能靠自觉 -
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }：ESLint 自动修复，比手动eslint --fix更可靠 -
"files.trimTrailingWhitespace": true和"files.insertFinalNewline": true：防尾随空格和缺失换行符
注意："editor.suggest.snippetsPreventQuickSuggestions" 建议设为 true，否则某些补全插件（如 GitHub Copilot）会干扰 ESLint 快速修复提示。
如何让不同语言栈团队共用同一套格式规则
前端、后端、AI 工程师可能用不同语言，但缩进、换行、空格逻辑应一致。靠多个语言专属插件各自配置极易冲突——Prettier 是唯一能横跨 JS/TS/JSON/YAML/HTML/CSS 的通用格式器。
- 在
settings.json中统一指定："editor.defaultFormatter": "esbenp.prettier-vscode" - 禁用其他语言插件的格式化能力：
"[javascript]": { "editor.formatOnSave": false }（同理关掉[typescript]、[json]等） -
.prettierrc里只保留与团队强共识相关的项，例如："semi": false、"singleQuote": true、"printWidth": 100 - 务必搭配
eslint-config-prettier关闭 ESLint 中所有格式类规则，否则 ESLint 和 Prettier 会打架报错
Python 或 Go 团队可额外加 "[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }，但需明确文档说明：仅限该语言文件，不覆盖全局默认。
extensions.json 推荐插件怎么避免“推荐变强制”
.vscode/extensions.json 只是提示安装，无法强制。但跨部门协作中，有人漏装 Volar 或 ESLint 插件，会导致 Vue 文件无类型提示、TS 错误不标红——表面是配置问题，实则是环境缺失。
- 在
extensions.json中只列真正影响代码正确性的核心插件："Vue.volar"、"dbaeumer.vscode-eslint"、"esbenp.prettier-vscode" - 禁用“锦上添花”型插件（如主题、图标包），它们不该进团队配置
- 配合
settings.json做兜底：比如"eslint.runtime": "./node_modules/.bin/node"，确保即使没装 ESLint 插件，命令行也能跑通 - 新人入职 checklist 必须包含：“打开项目 → 点击右下角‘Install Recommended Extensions’”
真正容易被忽略的是：VSCode 的插件推荐只在首次打开工作区时弹出一次。如果成员之前打开过同名文件夹（哪怕不是这个 Git 仓库），就不会再提示——所以命名 team.code-workspace 比直接用文件夹名更可控。
