重置 VS Code 用户配置需删除 User 目录及 extensions 文件夹;仅刷新界面用“Developer: Reload Window”和“View: Reset View Locations”;彻底清理还需删除 Cache、CachedData 和 logs。

重置 VS Code 用户配置(最常用场景)
VS Code 没有“一键恢复出厂设置”的菜单项,所谓“刚安装的状态”,本质是清空所有用户级自定义:扩展、设置、快捷键、片段、UI 布局等。核心操作是重置 User 目录,而非卸载重装。
-
Windows:关闭 VS Code 后,删除
%APPDATA%\Code\User和%USERPROFILE%\.vscode\extensions -
macOS:删除
~/Library/Application Support/Code/User和~/.vscode/extensions -
Linux:删除
~/.config/Code/User和~/.vscode/extensions
⚠️ 注意:extensions 文件夹删的是已安装的扩展(不包括 marketplace 缓存),User 文件夹里最关键的三个文件是 settings.json、keybindings.json、snippets/ —— 它们一删,编辑器就“变干净”了。
保留系统级设置但清空工作区记忆
如果你只希望当前窗口回到初始状态(比如忘记关了哪些面板、终端、调试视图),而不是全局重置,直接用命令面板更安全:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并执行
Developer: Reload Window—— 仅刷新 UI 状态,不改配置 - 再执行
View: Reset View Locations—— 重置侧边栏、面板、编辑器组位置
这个组合能解决 80% 的“界面错乱”问题,且不会动你任何 settings.json 里的偏好。
彻底清除(含语言服务器、缓存、日志)
极少数情况(如 TypeScript 语言服务卡死、插件持续崩溃、启动异常),需要连带清理缓存和语言服务器数据:
- 关闭 VS Code
- 删除
Code\Cache(各平台对应路径同上) - 删除
Code\CachedData(存储语法高亮、补全索引等) - 删除
Code\logs(纯日志,可选)
⚠️ 警告:删 CachedData 后首次打开大型项目会明显变慢,因为 TS/JS 语言服务要重建整个项目索引 —— 这不是 bug,是预期行为。
为什么不能只删 settings.json?
单独删 settings.json 是最轻量的操作,但往往不够。因为:
- 扩展可能在本地写入自己的配置到
User下其他 JSON 文件(比如tasks.json、launch.json) - 某些 UI 状态(如已折叠的侧边栏区域、活动的调试配置)由二进制缓存控制,不随 JSON 删除而重置
- VS Code 1.85+ 开始,部分设置(如编辑器缩放、窗口大小)会写入
storage.json,也在User目录下
所以“只删 settings.json”常让人误以为没生效 —— 实际是其他残留文件还在起作用。









