VSCode 重置需分步操作:先清空 settings.json(留{}),无效则重命名 User 目录备份后重启;启动异常时用 code --disable-extensions 排查;务必关闭 Settings Sync 并清理工作区配置及系统缓存。

VSCode 没有“恢复出厂设置”按钮,所谓重置本质是清空你改过的配置——settings.json 里非法 JSON、残留插件字段、损坏的 keybindings.json 都会让编辑器卡死或行为异常。最可靠的做法不是删文件,而是清空内容或重命名整个 User 目录。
清空 settings.json 是最快见效的轻量操作
多数启动卡顿、扩展不加载、设置不生效,问题就出在 settings.json 里写了非法 JSON:比如用了 // 注释、多了一个逗号、引号没闭合,或者引用了已卸载插件的配置项。
- 用
Ctrl + Shift + P(Windows/Linux)或Cmd + Shift + P(macOS)打开命令面板 - 输入并选择
Preferences: Open Settings (JSON) - 把全部内容删掉,只留
{}——注意不是删除文件本身,也不是留空行 - 保存(
Ctrl + S),完全退出 VSCode 后再重启
如果这时还异常,说明问题不在 settings.json,而是其他用户数据文件(如 keybindings.json 或 storage.json)也坏了。
重命名 User 目录才是彻底重置的关键动作
只删 settings.json 不够,因为快捷键、代码片段、UI 状态缓存、甚至某些插件的本地状态都存在 User 目录下。直接删目录风险高,推荐先重命名备份:
- 确保 VSCode 完全退出(macOS 查活动监视器,Windows 查任务管理器,确认无
Code Helper进程) - 按平台打开对应路径:
macOS:$HOME/Library/Application Support/Code/User/
Linux:$HOME/.config/Code/User/
Windows:%APPDATA%\Code\User\ - 把整个
User文件夹重命名为User_backup(不是删除) - 重启 VSCode,它会自动生成全新
User目录和默认settings.json
这样既干净,又保留了找回部分配置的余地——比如你想恢复某个自定义 snippet,可以去 User_backup/snippets/ 里手动抄过去。
启动时跳过用户配置验证是否真为配置问题
如果你连命令面板都打不开,或者一开就崩溃,得先排除扩展干扰和配置污染:
- 终端执行:
code --disable-extensions(macOS/Linux)或code --disable-extensions(Windows,确保code在 PATH) - VSCode 会以纯净模式启动,不加载任何扩展、不读取
User目录下的配置 - 此时再打开命令面板,尝试
Preferences: Open Settings (JSON)或直接执行Developer: Reset User Data - 若能正常操作,说明问题确实出在扩展或用户数据;若仍异常,可能是安装体损坏或磁盘写入错误
别只点「Sign Out」,那不关同步——必须在设置里关掉 Settings Sync,否则重启后配置又自动拉下来。
别漏掉工作区配置和缓存路径
很多人重置完 User 目录,发现某个项目还是异常,是因为工作区配置(.vscode/settings.json)优先级更高,会覆盖用户设置:
- 检查当前项目根目录下是否有
.vscode/文件夹,里面含settings.json、launch.json等 - 若想全局重置,可删掉该文件夹;若只针对某项目,只删其
.vscode/即可 - Windows 用户还要留意:
%LOCALAPPDATA%\Code\Cache和CachedData有时也会导致 UI 渲染异常,可一并清空
真正容易被忽略的是:macOS 的 Library/Caches/com.microsoft.VSCode 和 Windows 的 %LOCALAPPDATA%\Code 下的缓存,它们不会随 User 目录重建而刷新,得手动清理才彻底。











