重置VSCode全局设置最有效的方式是清空settings.json为{}或重命名整个User目录;前者快速但可能遗漏问题,后者彻底但会丢失快捷键、代码片段和UI布局。

重置 VSCode 全局设置没有“一键还原”按钮,真正起效的只有两种方式:清空 settings.json 为 {},或重命名整个 User 目录;前者快但可能遗漏问题,后者彻底但会丢失快捷键、代码片段和 UI 布局。
清空 settings.json 是最快验证起点
绝大多数全局设置异常(字体崩了、主题不生效、自动保存失效、行号消失)都源于这个文件里写了非法 JSON 或引用了已卸载插件的字段。VSCode 不报错,而是静默跳过整个文件——你改了半天,其实根本没加载。
- 用
Cmd + Shift + P(macOS)或Ctrl + Shift + P(Windows/Linux)打开命令面板 - 输入并选择
Preferences: Open Settings (JSON) - 全选内容 → 替换为
{}→Cmd+S/Ctrl+S保存 - 必须彻底退出 VSCode:macOS 查「活动监视器」中是否有
Code Helper进程,Windows 查任务管理器 - 重启后若恢复默认行为,说明问题就在这儿;若仍异常,说明还有其他配置文件在起作用
重命名 User 目录才是真·重置
只动 settings.json 不够,因为快捷键存在 keybindings.json,代码片段在 snippets/,UI 状态缓存写在 storage.json,某些插件甚至把状态塞进 globalStorage/。一个多余逗号就能让整个快捷键系统静默失效。
- 确认 VSCode 已完全退出(进程清零)
- 找到对应路径:
— Windows:%APPDATA%\Code\User\
— macOS:~/Library/Application Support/Code/User/
— Linux:~/.config/Code/User/ - 把整个
User文件夹重命名为User_backup(不是删除) - 重启 VSCode,它会自动生成全新
User目录和空的settings.json、keybindings.json
Settings Sync 开着就等于白重置
很多人删完 User 目录重启,发现设置又回来了。这不是故障,是 Settings Sync 在后台自动从 GitHub/GitLab 拉取了上次同步的配置。关不关它,决定重置是否生效。
- 先执行
Preferences: Turn Off Settings Sync - 务必勾选
Turn Off and Reset Local State - 重启后验证:
settings.json内容应为{},右下角齿轮旁不能有云朵图标 - 如果已经同步回去了,得先登出账户,再手动清理云端配置(GitHub/GitLab 的
vscode-syncgist 或 repo)
code --disable-extensions 启动可快速隔离问题
如果你连命令面板都打不开,或者一开就崩溃,说明问题可能已超出配置文件范畴,比如扩展冲突或安装体损坏。这时需要绕过所有用户数据启动。
- 终端执行:
code --disable-extensions(确保code在 PATH 中) - VSCode 会以纯净模式启动,不加载任何扩展、不读取
User目录下的配置 - 此时再尝试
Preferences: Open Settings (JSON)或Developer: Reset User Data - 若能正常操作,说明问题确实出在扩展或用户数据;若仍异常,就得考虑重装或检查系统级缓存(如 macOS 的
~/Library/Caches/com.microsoft.VSCode.ShipIt)
真正麻烦的从来不是删哪个文件,而是删完之后发现某个自定义 keybinding 或 snippet 真有用,又记不清具体怎么写的——所以重命名比删除安全,备份比清空可靠。别省那几秒,多点一次 Finder 或资源管理器,能少踩半天坑。











