VSCode全局设置不生效，主因是配置被高优先级设置覆盖或路径错误：①用户级settings.json路径必须精准（Windows为%APPDATA%\Code\User\settings.json，macOS为~/Library/Application Support/Code/User/settings.json，Linux为~/.config/Code/User/settings.json）；②工作区配置（.vscode/settings.json）优先级更高，会静默覆盖用户设置；③远程开发时本地配置无效，需编辑远程端对应路径的settings.json；④插件可能通过API动态覆写设置，可用code --disable-extensions排查。
VSCode 全局设置（比如 search.exclude、editor.fontSize 等）不生效，几乎总是因为配置被更高优先级的设置覆盖，或者根本没写进 VSCode 实际读取的位置——不是“没保存”，而是“没被看到”。
settings.json 路径错了，VSCode 就当它不存在
VSCode 只认特定路径下的 settings.json，手动生成或复制粘贴到错地方，等于白干。
- Windows：必须放在
%APPDATA%\Code\User\settings.json（不是AppData\Roaming\Code\User下的别名或快捷方式） - macOS：必须是
~/Library/Application Support/Code/User/settings.json（不是~/Library/Preferences/Code或~/Library/Caches/Code） - Linux：必须是
~/.config/Code/User/settings.json（注意.config是隐藏目录，且大小写敏感） - 如果该文件权限为只读（比如企业策略锁定），VSCode 会静默跳过，不报错也不提示
工作区 settings.json 优先级永远高于用户设置
只要当前打开了某个文件夹（即处于工作区模式），VSCode 就会先加载 .vscode/settings.json，里面任何同名配置都会直接覆盖用户级设置，且不加提示。
- 打开命令面板
Ctrl+Shift+P，运行Preferences: Open Settings (JSON)，看顶部路径是否带.vscode/—— 如果是，你正在编辑工作区配置 - 检查
.vscode/settings.json是否有"search.exclude"、"editor.tabSize"等字段，哪怕值是null或空对象，也会阻断用户级继承 - 临时验证：关闭当前文件夹（
File > Close Folder），再试设置，若突然生效，就坐实了工作区覆盖
远程开发（SSH/WSL）完全不读本地用户设置
你在本地 Windows 上改好了 settings.json，但连的是 WSL 或远程 Linux 主机？那套配置对远程实例毫无意义——远程 VS Code Server 有自己的用户目录和配置路径。
- 远程实例的
settings.json路径是：~/.config/Code/User/settings.json（WSL）或对应远程用户的家目录 - 不能靠“同步设置”自动解决：同步功能默认只同步部分设置，且需手动开启、登录同一账号、并确认远程端已启用同步
- 最稳做法：在远程窗口里，用
Ctrl+Shift+P运行Preferences: Open Settings (JSON)，直接编辑远程端的配置文件
扩展或插件主动修改设置，且不暴露 UI
某些扩展（尤其是主题类、AI 补全类、企业安全插件）会在启动时调用 API 直接覆写设置，这类修改不会出现在 settings.json 里，也看不到绑定记录。
- 运行
Developer: Toggle Developer Tools，切换到 Console 标签页，搜索updateValue或configuration，看是否有扩展在初始化阶段调用workspace.getConfiguration().update() - 用
code --disable-extensions启动无扩展版 VSCode，测试设置是否恢复生效 - 重点排查近期新装的扩展，尤其是名称含 “theme”、“ai”、“security”、“policy” 的插件
真正难搞的不是“找不到设置在哪改”，而是改完后不知道谁在背后悄悄把它又扳回去了——尤其在团队共用项目、企业环境或远程开发场景下，覆盖链可能跨三层（系统策略 → 扩展 → 工作区），得一层层剥开看日志和路径才敢确定。
