VS Code 全局 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 中同名配置覆盖,且部分设置项(如 search.include)仅限工作区使用,全局写入会被静默忽略。

全局 settings.json 放在哪,改了为什么没生效
VS Code 的用户级 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)覆盖——这是“改了没生效”最常见原因。检查是否项目里有 .vscode/settings.json,且里面写了同名配置项,比如 "editor.tabSize": 4;只要它存在,用户设置里的 "editor.tabSize": 2 就完全不起作用。
哪些配置适合放全局,哪些必须留到工作区
全局设置该管“人”,不该管“项目”。适合放这里的包括:"editor.fontSize"、"workbench.colorTheme"、"files.autoSave"、"editor.suggest.snippetsPreventQuickSuggestions" 这类纯个人习惯项;而涉及语言行为、格式化规则、路径、调试器路径等,必须交给工作区或文件夹级配置。例如:"prettier.singleQuote" 应该写在项目 .vscode/settings.json 或 .prettierrc 里,否则团队协作时别人拉代码就格式不一致;"python.defaultInterpreterPath" 更不能放全局,不同项目 Python 环境很可能不同。
性能敏感项必须全局关,否则开大项目就卡
这些配置一旦启用,会在每个打开的窗口里无差别加载,是大型项目卡顿的元凶:
-
"typescript.validate.enable": false和"javascript.validate.enable": false—— 关闭内置 JS/TS 验证,让 ESLint 插件接管更可控 -
"editor.codeLens": false—— CodeLens(如函数引用数、测试运行按钮)非常吃资源 -
"git.enabled": false—— 大仓库中 Git 状态轮询会持续占用 CPU,建议只在需要时手动启用 -
"files.watcherExclude"里补全常用路径,比如"**/node_modules/**"、"**/dist/**"、"**/build/**",避免文件监听器扫遍整个目录树
别碰“自动保存 onFocusChange”,它会悄悄毁掉你的编辑节奏
很多人设 "files.autoSave": "onFocusChange" 是为了防丢,结果发现切到终端或浏览器再切回来,代码被提前格式化、import 被重排、甚至未完成的语句被自动补全截断。真正安全的是 "files.autoSave": "afterDelay",并配合 "files.autoSaveDelay": 1000(1秒延迟)。这样既防崩溃丢失,又不会打断思考流。另外,"editor.formatOnSave" 必须和项目级格式化器绑定(如 Prettier),不能只靠全局开关,否则不同项目格式风格会打架。
全局配置不是“一劳永逸”的起点,而是你和编辑器建立稳定交互节奏的锚点。最容易被忽略的是:它永远在后台默默让渡控制权给工作区,而多数人直到提交代码后发现缩进错乱、格式化失效,才意识到自己一直活在别人的 .vscode/settings.json 阴影下。











