清空 settings.json 为 {} 即可恢复默认配置;误删文件会导致缓存旧配置,应避免;重置单个配置项推荐用设置界面的 reset setting;语法错误常致启动卡死,可用 --disable-extensions 排查;彻底重置可删除整个 user 目录。

settings.json 文件损坏或误改,直接清空内容即可恢复默认
VSCode 的用户配置不会“永久写死”,只要 settings.json 是合法 JSON(哪怕只有 {}),它就会在重启时自动补全默认值。最常踩的坑是删掉整个文件——VSCode 不会自动生成新文件,反而可能沿用缓存旧配置,导致行为诡异。
- 正确做法:打开
Preferences: Open Settings (JSON),把全部内容删光,只留{},保存后重启 - 错误做法:删除
settings.json文件本身(路径见下条),VSCode 会跳过加载,仍按上一次有效配置运行 - Windows 路径:
C:\Users\{用户名}\AppData\Roaming\Code\User\settings.json - macOS 路径:
~/Library/Application Support/Code/User/settings.json - Linux 路径:
~/.config/Code/User/settings.json
重置单个配置项,别手动改 JSON —— 用设置界面的 “Reset Setting”
只想还原某一项(比如 editor.fontSize 或 files.autoSave),硬改 JSON 容易漏逗号、多引号、加注释(// 在 JSON 中非法,VSCode 会静默忽略其后所有配置)。
- 快捷键
Ctrl + ,打开设置页,在搜索框输入@modified,立刻看到所有被改过的项 - 鼠标悬停在对应配置行首,点齿轮图标
⚙️→ 选Reset Setting - 对嵌套项如
editor.fontFamily,重置会递归清理子字段,比手动删更干净
VSCode 启动卡死 / 扩展不加载 / 界面异常?大概率是 settings.json 语法出错
这类问题几乎都指向 settings.json 里写了非法内容:多了逗号、少了引号、用了 // 注释、引用了已卸载扩展的配置项(如 "prettier.requireConfig" 但 Prettier 扩展没装)。
- 先用
code --disable-extensions启动,排除扩展干扰 - 再打开命令面板(
Ctrl + Shift + P),执行Preferences: Open Settings (JSON) - 检查控制台(
Developer: Toggle Developer Tools)是否有Unexpected token类报错 - 确认无误后,仅保留
{}并保存,再正常重启
想彻底干净重置?删 User 目录,但注意 keybindings.json 和 snippets 也会消失
如果连快捷键、代码片段、登录状态都不要了,删整个 User 目录是最彻底的办法。VSCode 重启后会重建该目录,并生成全新默认的 settings.json、keybindings.json 等。
- 操作前务必退出 VSCode 全进程(macOS 检查 Activity Monitor 有无
Code Helper) - 删的是
Code/User/整个文件夹,不是只删settings.json - 已安装的扩展不受影响(它们在
Code/extensions/下),但扩展的本地设置(如 Prettier 的项目级开关)会丢失 - 若你用过自定义快捷键,删了就真没了——没有自动备份机制
.vscode/settings.json,即使用户级已重置,工作区配置仍会覆盖。排查时得两个地方一起看。










