settings.json 格式错误(如注释、逗号、引号问题)会导致vscode启动卡死、扩展失败或设置不生效,应清空内容为{}并重启;若仍异常,需重命名user文件夹重建;重装前须清理缓存路径,保留extensions可复用扩展。

settings.json 写错导致启动卡死或配置不生效
VSCode 启动慢、扩展加载失败、设置界面空白,大概率是 settings.json 里混入了非法 JSON:比如用了 // 注释、多了一个逗号、引号没闭合,或者引用了已卸载扩展的配置项。VSCode 不会报错,而是静默跳过整个文件——你改了半天,其实根本没生效。
- 打开命令面板(
Cmd + Shift + P或Ctrl + Shift + P),输入并选择Preferences: Open Settings (JSON) - 把文件内容全删掉,只留
{},**不是删除文件本身,也不是留空行** - 保存(
Cmd + S),完全退出 VSCode(macOS 要确认“活动监视器”里没有Code Helper进程) - 再启动,就能恢复默认行为;如果还是异常,说明问题不在
settings.json,往下走
禁用所有扩展后仍无法打开命令面板或 UI 异常
这时候可能是用户数据目录整体损坏,比如 keybindings.json 格式错误、snippets 目录里有非法文件,甚至 storage.json(UI 状态缓存)写坏。单清 settings.json 已经不够用了。
- 彻底退出 VSCode,按下
Cmd + Shift + G(macOS)或在资源管理器地址栏直接粘贴路径(Windows:%APPDATA%\Code;Linux:~/.config/Code) - 找到并进入
User文件夹,把它整个重命名为User.bak(不是删,先备份) - 重启 VSCode,它会自动生成全新的
User目录和空的settings.json、keybindings.json - 如果需要找回部分配置,可以打开
User.bak/keybindings.json对比,但别直接覆盖——挑着抄,跳过可疑字段
重装 VSCode 前必须清理的两个隐藏路径
只用控制面板卸载或删 App 图标,90% 的配置和缓存还在硬盘上。尤其 macOS 和 Windows 的 AppData 或 Library 下,藏着真正影响“出厂感”的残留。
- macOS:除了
~/Library/Application Support/Code/User,还要检查~/Library/Caches/com.microsoft.VSCode.ShipIt和~/Library/Preferences/com.microsoft.VSCode.helper.plist - Windows:除
%APPDATA%\Code外,%LOCALAPPDATA%\Code里的Cache、CachedData也得清——否则重装后可能复用旧缓存,照样出问题 - Linux:
~/.config/Code和~/.cache/Code都要处理 - 删完再装官网最新版(别用 Homebrew 或 Mac App Store 版本覆盖安装,容易混版本)
想保留扩展但清除所有个性化设置
扩展本身存在 extensions 目录里,和 User 目录是分开的。所以你可以安全地只动 User,而不用重装任何插件。
- 关闭 VSCode,进用户数据目录(如 macOS 的
~/Library/Application Support/Code) - 删掉
User文件夹,但保留extensions文件夹不动 - 重启 VSCode,它会重建
User,所有扩展还在,只是设置、快捷键、片段都变默认了 - 注意:扩展的「本地状态」(比如某个主题上次记的字体大小)可能还在
extensions子目录里,若需彻底干净,得进每个扩展文件夹手动删state.json类文件——一般没必要
settings.json 文件本身,而不是清空内容。VSCode 会 fallback 到缓存的旧配置,导致你以为重置了,其实啥都没变。留着文件,只留 {},才是真归零。











