VSCode 启动时显示 Untitled-1 是因默认启用会话恢复:关闭前未保存的空标签页被记住并还原;解决方法是将设置中“Window: Restore Windows”改为 none,或临时执行“Developer: Reload Window”后重新打开文件夹。

为什么 VSCode 启动时总带一个 Untitled-1
这不是项目配置错误,而是 VSCode 的默认会话恢复行为:它会记住上次关闭时所有打开的编辑器标签页(包括未保存的 Untitled 文件),并在下次启动时原样还原。如果你上次关掉前不小心留了一个空的 Untitled-1,它就会每次跟着项目一起弹出来。
关闭「自动恢复上次会话」的两种方式
根本解法是禁用会话级恢复,只保留工作区/文件夹级的打开状态:
- 打开设置(
Ctrl+,或Cmd+,),搜索restore Windows - 把
Window: Restore Windows改成none(不是all或folders) - 同时确认
Files: Auto Save是off或afterDelay—— 如果设为on,未命名文件可能被意外写入临时位置,干扰恢复逻辑
改完后重启 VSCode,再打开项目,就不会再看到那个顽固的 Untitled-1 了。
如果只想清理当前残留,不改全局设置
可以快速清除当前窗口的“恢复痕迹”,适合临时处理:
- 先关闭所有标签页(包括
Untitled-1),但不要关掉整个窗口 - 执行命令面板(
Ctrl+Shift+P/Cmd+Shift+P),输入并运行Developer: Reload Window - 再通过
File > Open Folder...重新打开你的项目目录
这个操作跳过了会话恢复流程,相当于“干净启动”,但下次全关再开仍可能复现 —— 所以长期还是建议调 Window: Restore Windows。
插件或用户数据损坏也可能导致异常恢复
极少数情况下,即使设置正确,Untitled 仍顽固出现,可能是 storage.json 或 workspaces.json 缓存出错:
- 退出 VSCode
- 删除用户数据中的工作区缓存:
~/.vscode/storage.json(Linux/macOS)或%APPDATA%\Code\storage.json(Windows) - 注意:别删整个
~/.vscode目录,只动storage.json和同级的workspaces子目录即可
重装插件或重置设置通常没必要,问题几乎都出在恢复策略和缓存这两层。真正容易被忽略的是:很多人只改了 Files: Hot Exit,却没碰 Window: Restore Windows —— 前者管“关窗口时不提示保存”,后者才管“开窗口时恢复什么”。


















