vscode启动异常（白屏、卡死等）多因用户配置文件损坏，如settings.json语法错误；清空其内容为{}并彻底退出重启可快速验证，若无效则需重命名user目录并关闭settings sync。
VSCode 启动异常（白屏、卡死、命令面板打不开、快捷键失效）基本不是安装体损坏，而是用户配置文件出错——settings.json 里一个多余逗号、keybindings.json 中引号不闭合、或 locale.json 被手动改坏，都会让 VSCode 静默跳过整个文件，却不报错。
清空 settings.json 是最快见效的轻量操作
多数启动卡顿、扩展不加载、设置不生效，问题就出在 settings.json。VSCode 不校验 JSON 合法性，非法内容（如 // 注释、"editor.fontSize": "14" 字符串值、多逗号）会导致它直接跳过整个文件。
- 按
Ctrl + Shift + P（Windows/Linux）或Cmd + Shift + P（macOS），输入并选择Preferences: Open Settings (JSON) - 全选内容 → 替换为
{}（不是删文件，也不是留空行） -
Ctrl + S保存，**彻底退出 VSCode**（Windows 查任务管理器，macOS 查活动监视器确认无Code Helper进程） - 重启，若恢复正常，说明问题就在这儿
重命名 User 目录才是彻底重置的关键动作
只清 settings.json 不够——快捷键失效、侧边栏消失、终端位置错乱、代码片段不触发，往往源于 keybindings.json、snippets/、storage.json 或插件在 globalStorage/ 里写坏的状态。这些文件不报错，但会静默瘫痪对应功能。
- 确保 VSCode 完全退出
- 按平台打开对应路径：
Windows：%APPDATA%\Code\User\
macOS：$HOME/Library/Application Support/Code/User/
Linux：$HOME/.config/Code/User/ - 把整个
User文件夹重命名为User_backup（不是删除） - 重启 VSCode，它会自动生成全新
User目录和默认空文件（settings.json、keybindings.json等）
必须关掉 Settings Sync 否则重置等于白干
你刚重命名完 User 目录，一重启所有旧配置又回来了？不是 VSCode 故障，是 Settings Sync 在后台自动从云端拉取了历史配置。这个同步逻辑是「本地缺失 → 立即拉取」，关不关它，决定重置是否生效。
- 执行
Ctrl + Shift + P→ 输入并选择Preferences: Turn Off Settings Sync - 务必勾选
Turn Off and Reset Local State - 重启后验证：
settings.json内容应为{}，右下角齿轮旁不能有云朵图标
启动时连命令面板都打不开？先用纯净模式排查
如果连 Ctrl + Shift + P 都触发不了，说明问题已超出配置文件范畴，可能是扩展冲突或缓存写崩。此时别急着删文件，先用命令行隔离干扰：
- 终端执行：
code --disable-extensions（确保code在 PATH） - VSCode 以纯净模式启动：不加载任何扩展、不读
User目录、不触发同步 - 此时再尝试
Preferences: Open Settings (JSON)或Developer: Reset User Data - 若能正常操作，说明问题确实出在扩展或用户数据；若仍异常，需检查系统级缓存（如 macOS 的
~/Library/Caches/com.microsoft.VSCode.ShipIt）
真正容易被忽略的是：重命名 User 目录后，extensions/ 下的插件本体还在，但所有插件的本地状态（登录态、上次打开的终端、自定义 UI 修改）全丢了；而 storage.json 这种 UI 状态缓存一旦损坏，甚至不会体现在 JSON 文件里，只能靠重命名整个目录才能重建。
