VSCode配置异常时可重置为默认状态:一、命令面板清空settings.json;二、删除~/Library/Application Support/Code/User/目录;三、code --disable-extensions启动后清理;四、重装并手动恢复扩展。

如果您发现 VSCode 的设置无法保存、扩展无法加载或界面行为异常,则可能是用户配置文件(settings.json)或工作区配置文件损坏。以下是将 VSCode 重置为默认状态的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、通过命令面板重置用户设置
此方法利用 VSCode 内置的“重置设置”功能,仅清除用户级别的 settings.json 内容,保留已安装扩展和快捷键绑定,是最轻量级的恢复方式。
1、启动 VSCode,按下 Cmd + Shift + P(Windows/Linux 为 Ctrl + Shift + P)打开命令面板。
2、输入并选择 Preferences: Open Settings (JSON),打开当前用户 settings.json 文件。
3、清空该文件全部内容,仅保留一对空大括号 {}。
4、保存文件(Cmd + S),关闭并重新启动 VSCode。
二、删除用户配置目录
此操作会彻底移除用户级配置,包括 settings.json、keybindings.json、snippets 目录及 extensions 目录外的所有自定义数据,但不会影响已安装的扩展本身(扩展数据保留在 extensions 目录中)。
1、完全退出 VSCode(确保进程已终止,可在活动监视器中确认无 Code Helper 进程)。
2、在访达中按下 Cmd + Shift + G,输入路径:~/Library/Application Support/Code/User/。
3、将该目录内的所有文件与子目录(如 settings.json、keybindings.json、snippets/)全部移入废纸篓。
4、重新启动 VSCode,系统将自动重建默认 User 目录及空配置文件。
三、使用 --disable-extensions 启动并重置
当配置损坏导致扩展加载失败、界面卡死或命令面板不可用时,可先禁用所有扩展启动,再执行配置清理,避免扩展干扰重置过程。
1、在终端中执行:code --disable-extensions(确保已将 code 命令添加至 PATH)。
2、VSCode 将以纯净模式启动,不加载任何扩展及自定义 UI 修改。
3、在该会话中打开命令面板,执行 Developer: Open Developer Tools,确认控制台无报错后,再执行步骤一或二的操作。
四、重装 VSCode 并保留扩展与全局配置
若上述方法均无效,且怀疑安装本体或缓存数据库(如 workspace storage)损坏,可通过重装方式重建环境,同时手动备份并恢复关键扩展数据。
1、从官网下载最新版 VSCode 安装包(.zip 或 .dmg),不要使用 Homebrew 或 Mac App Store 版本进行覆盖安装。
2、将原应用拖入废纸篓,并在终端中运行:rm -rf ~/Library/Caches/com.microsoft.VSCode* 和 rm -rf ~/Library/Saved Application State/com.microsoft.VSCode.savedState。
3、安装新版本后,打开命令面板,执行 Extensions: Show Installed Extensions,逐一启用此前已安装的扩展。










