真正起效的重置是执行view: reset view locations命令或重命名storage.json;前者秒恢复默认面板位置,后者强制重建ui状态缓存,二者均不依赖settings.json,且比重命名user目录更安全高效。

VSCode 启动时布局错乱(比如侧边栏消失、终端跑到了顶部、编辑器分栏错位),不是 settings.json 里某个开关没开,而是 UI 状态缓存已损坏;真正起效的重置动作是清空 storage.json 或执行 Reset View Locations 命令,而非改设置或删配置文件。
为什么改 window.restoreWindows 没用
这个设置只控制“是否恢复上次打开的文件和窗口数量”,不负责面板位置、大小、折叠状态等 UI 布局。即使设为 "all",若 storage.json 里记录的视图坐标异常(比如负数宽度、非法 dock 位置),VSCode 仍会渲染出错位或隐藏的面板。
-
storage.json存在User目录下,是 VSCode 自动写入的二进制友好型 JSON,人工编辑极易破坏结构 - 插件(尤其是主题类、UI 增强类)可能直接写坏该文件,重启后布局就“漂移”
- 手动修改
workbench.editor.restoreViewState或workbench.layout不生效——这些字段在新版中已被弃用或仅作只读参考
快速恢复默认布局的两种可靠方式
优先尝试命令行级操作,避免误删数据:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)打开命令面板,输入并执行View: Reset View Locations—— 这会立即把所有面板(Explorer、Terminal、Debug、Problems 等)拖回默认位置,且不重启 - 如果执行后仍异常,关闭所有 VSCode 窗口,找到
User目录下的storage.json文件,**重命名它为storage.json.bak**(不是删除),再重启 VSCode;它会自动生成新storage.json并使用内置默认布局 - 注意:
Reload Window(Ctrl+R)不能修复布局,它只刷新渲染层,不重载 UI 状态缓存
重命名 User 目录前必须确认的三件事
这是根治方案,但代价高,仅当 Reset View Locations 和重命名 storage.json 都无效时才用:
- 必须先关闭 Settings Sync:左下角齿轮 →
Settings Sync: Turn Off→ 选Turn Off and Reset Local,否则重启瞬间同步回旧布局 - 确认 VSCode 进程已清零:macOS 查「活动监视器」里有没有
Code Helper,Windows 查任务管理器里的Code.exe及子进程 - 路径要找对:
%APPDATA%\Code\User\(Win)、~/Library/Application Support/Code/User/(macOS)、~/.config/Code/User/(Linux),重命名整个User文件夹为User_backup,别删
真正容易被忽略的是:布局异常往往不是单一文件问题,而是 storage.json + 插件写入的 globalStorage + 某些扩展的本地缓存共同作用的结果;所以不要只盯 settings.json,也别一上来就重装——先用 Reset View Locations 和重命名 storage.json 试两次,90% 的布局错乱当场解决。











