工作区设置没生效的主因是VS Code未以文件夹为工作区打开，或配置被权限、同步设置、扩展优先级、多根工作区覆盖等干扰；需通过设置UI右图标确认生效层级并实测验证。
工作区设置为什么没生效？常见失效原因
明明写了 .vscode/settings.json，但缩进还是 4 格、ESLint 还是不跑——大概率不是配置写错了，而是根本没被加载。
- VS Code 没以该文件夹为“工作区”打开：必须用 File → Open Folder，而不是双击某个
.js文件单独打开 -
.vscode文件夹权限受限（尤其 macOS 外接磁盘或某些 Docker 卷），VS Code 写入失败，连带读取也跳过 - 设置了
"settingsSync.ignoredSettings": ["editor.fontSize"]，同步服务把本该继承的配置给过滤掉了 - 扩展自己抢了控制权：比如 Prettier 插件优先读
.prettierrc，无视prettier.semi这类settings.json里的配置
哪些配置该放用户层，哪些必须放工作区？
不是“能不能放”，而是“放错地方就会出问题”。核心判断标准就一条：这个配置是否和当前项目强绑定。
- 放用户设置（
settings.json）的："editor.fontSize"、"workbench.colorTheme"、"files.autoSave"、"terminal.integrated.defaultProfile.linux" - 必须放工作区（
.vscode/settings.json）的："python.defaultInterpreterPath"（指向项目venv）、"typescript.preferences.includePackageJsonAutoImports"、"eslint.packageManager"（设为"pnpm"而非全局"npm"） - 绝对不能放工作区的：
"http.proxy"（除非全团队共用代理）、"github.gitAuthentication"、任何含token或key的字段——它们不该进 Git
多根工作区下，.vscode/settings.json 和 .code-workspace 怎么配合？
当你用 File → Add Folder to Workspace 加了多个目录，VS Code 就不再只认单个 .vscode/settings.json，而是生成一个顶层 .code-workspace 文件来统筹。
-
.vscode/settings.json仍对所在子文件夹生效，但仅限于该文件夹内未被.code-workspace显式覆盖的项 -
.code-workspace中的"settings"字段优先级高于所有子文件夹的.vscode/settings.json，适合统一管理跨模块的规则，比如全 workspace 禁用editor.formatOnSave - 如果某个子文件夹需要例外行为（例如 docs 目录要开 Markdown 预览自动刷新），只能在它自己的
.vscode/settings.json里重写，且确保.code-workspace没锁死该配置
怎么快速确认当前生效的是哪一层配置？
别猜，直接看 VS Code 设置 UI 右侧的小图标——它比文档更诚实。
- 图形界面中，每条设置右侧出现 ⚙️ 表示来自用户设置；出现 ? 表示来自当前工作区
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Preferences: Open Settings (JSON)：如果已打开文件夹，它会自动打开.vscode/settings.json；否则打开用户级settings.json - 命令面板里搜
Preferences: Open Workspace Settings (JSON)，能强制打开工作区配置，哪怕当前还没创建.vscode/settings.json，它也会帮你新建
配置层级本身不复杂，难的是每次改完不确定到底动了哪一层。最稳妥的做法是：改之前先看右上角那个小图标，改之后立刻试一个真实文件（比如保存一个 .ts 看 ESLint 是否触发），而不是靠“应该生效了”去赌。
