说实话刚被问到“VS Code 自动打开窗口怎么关”这个问题时我还觉得挺简单的第一反应就是设置里关掉“恢复窗口”不就行了。结果连着帮几个朋友排查下来才发现同一个问题背后至少藏着好几种完全不一样的现象有人是不想每次启动都回到上次打开的文件夹有人是不想看到欢迎页有人是把“新建窗口”和“自动打开”搞混了还有人是在远程开发时被悄悄恢复了远端窗口。这问题看着小真要一次说透得把 VS Code 这套窗口恢复机制从头到尾理一遍。这篇文章就把它们全部掰开揉碎讲清楚。核心目标是让你彻底掌握 VS Code 里跟“窗口”相关的几个设置项哪个选项负责恢复旧窗口、哪个选项负责欢迎页、改完设置为什么有时候不生效以及远程开发、命令行、多配置文件这些场景下到底怎么配才不会再被“自动打开”黏住。无论你是刚装 VS Code 的新手还是用了很久但一直没细究过窗口行为的老手看完都能直接动手改。1. 先搞清楚你遇到的到底是哪一类“自动打开”盲改设置是最容易翻车的路子。很多人搜到window.restoreWindows就直接抄进配置结果发现没效果然后到处骂“教程骗人”。其实大多数情况不是设置错了而是你根本就没定位对现象。我把日常里最常见的几种“自动打开”分成三类你先对号入座。1.1 三类最常见的“自动打开”现象启动后恢复上次的所有窗口和文件夹这是最标准、最普遍的一种。你上次开着几个项目窗口每个窗口里又开着许多标签页、终端留在某个目录下。关掉 VS Code 再重新打开哗啦一下全部恢复连终端路径都跟昨天一模一样。启动后自动弹出欢迎页启动是启动了但没有恢复任何项目只是右侧或者编辑区冒出一个“Welcome”标签页带一串“Start”“Recent”“Getting Started”的快捷入口。点击文件夹或文件后总是另开新窗口你在资源管理器里双击一个代码文件夹或者点开一个.py文件结果不是复用当前窗口而是又冒出一个全新的 VS Code 窗口。这严格说不是“自动打开”但感受上跟“自动打开”是一模一样的而且经常被人混在一起问。除此之外还有个容易混淆的操作用快捷键CtrlShiftN或者菜单里的“新建窗口”那本来就是主动开新窗口跟“自动打开”不是一回事别被带偏。1.2 用一个观察动作快速定位类型我排查这个问题时习惯这么做先把 VS Code 完全退出然后在操作系统层面重新启动它别急着点任何东西。先观察三件事左侧资源管理器有没有项目目录编辑区打开的是旧标签页、欢迎页还是空白的 untitled 文件底部有没有自动冒出一个终端窗口如果左、中、底部都有内容回来那基本就是window.restoreWindows接管了整个窗口状态。如果只多了一个欢迎页那是启动编辑器设置的问题。如果窗口本身没有恢复任何项目但你从外部双击文件夹时总是新开窗口那问题出在“打开文件/文件夹时用新窗口”的规则上。这类现象可以整理成一个简单的诊断表你看到的现象主要涉及的设置处理优先级启动后所有标签页、终端、目录全部恢复window.restoreWindows先改这个启动后不恢复项目但出现欢迎页workbench.startupEditor同时检查从外部点击文件夹/文件总是新开窗口window.openFoldersInNewWindow/window.openFilesInNewWindow第三个检查远程窗口明明关了下次本地启动又自动连过去window.restoreWindows 远程配置文件层级专题处理先把现象判断准后面改配置就快得多。2. 主开关window.restoreWindows 是治本的关键window.restoreWindows就是控制“VS Code 启动时是否恢复上次窗口”的主开关绝大多数“自动打开问题”说的就是它。这个设置藏在工作台配置里位置很深但作用非常直接。下面我把几个可选项拆开讲每个值都得知道它在干什么。2.1 四个可选值的真实含义VS Code 官方文档里window.restoreWindows一共有四个值配置值行为说明all关闭 VS Code 时的所有窗口都会在下次启动时重新打开包括带工作区的窗口和空窗口。这是默认行为none启动时不恢复任何窗口每次都从一个干净的默认窗口开始one只恢复上一次处于活动状态的窗口。如果那个窗口现在不可用就打开默认窗口folder恢复带文件夹或工作区的窗口如果上次没有带文件夹的窗口就恢复最新的活动窗口默认情况下是all所以绝大多数人才会出现“打开 VS Code 就等于恢复昨天现场”的效果。这个设计的出发点倒不是折磨人而是微软想提供一种“无缝回到工作状态”的体验配合自动保存、终端历史等能力让人第二天打开编辑器就能接着干活。但对很多人来说这种“过度体贴”反而成了心理负担每次打开编辑器都看到一堆旧项目要么强迫自己清理要么被一堆标签页拖慢启动速度。2.2 图形界面修改方法不想碰 JSON 的话图形界面改也简单打开 VS Code按Ctrl,Mac 上是Cmd,进入设置界面。在搜索框里输入restore windows注意中间有空格。找到Window: Restore Windows这条设置下拉框默认显示all。改成none然后重启 VS Code 验证。界面设置改完会直接写入你的用户配置本质上跟我下面要说的 JSON 写法是一样的只是不用手动背配置项名称。2.3 settings.json 修改方法我个人更推荐直接改配置文件因为可以一次性把相关设置写在一起方便回头检查。按CtrlShiftP打开命令面板输入Preferences: Open User Settings (JSON)回车后会打开你的用户配置文件。在里面加上这么一段{ window.restoreWindows: none }如果文件里已经有内容注意别漏掉逗号最后再把配置保存。改完一定要完全退出VS Code不要只重载窗口我后面会专门说这个坑。2.4 哪些场景只改这一个设置还不够这里有个很多人没注意到的细节window.restoreWindows管的是“窗口级别”的状态恢复。也就是说它负责把旧窗口、旧文件夹、旧标签页拉回来但不负责欢迎页。就算你把restoreWindows设成none下次启动仍然可能出现欢迎页这是另一个设置workbench.startupEditor在管。所以只改这一个经常会出现“项目没恢复但欢迎页还是弹出来”的半吊子状态。另一个不生效的场景是远程开发Remote-SSH、WSL、容器。如果你上次关掉的是一个远程窗口而远程配置文件里又单独设置过restoreWindows用户级设置可能会被覆盖。这种情形我放到第 4 节专门讲。3. 和“自动打开”纠缠不清的邻居startupEditor 和新窗口策略只搞定window.restoreWindows你可能会觉得“怎么还有窗口弹出来”。这时候就得坐下来把一组互相纠缠的设置全部理顺。就好比你把大门关了但发现后门、侧门还开着要一次性全关上才行。3.1 workbench.startupEditor决定启动时显示什么编辑器workbench.startupEditor管的是“启动后第一个打开的编辑器内容”。它跟“恢复旧窗口”是两套逻辑一个负责恢复历史现场一个负责决定新现场长什么样。常见的几个值给你列一下配置值行为none启动后不主动打开任何编辑器标签页编辑器区域保持空白welcomePage启动后打开欢迎页newUntitledFile启动后新建一个未命名文件readme如果打开的文件夹里有 README则自动打开它welcomePageInEmptyWorkbench在没有打开任何项目时显示欢迎页有项目时不显示我个人最推荐的是none。打开 VS Code 后干干净净想开哪个文件自己动手不需要软件替我做决定。如果你反而喜欢欢迎页上的“Recent”快捷入口那就保留welcomePage但要注意restoreWindows仍然得设成none否则欢迎页只是个摆设真正的旧窗口还是会恢复。3.2 window.openFoldersInNewWindow 和 window.openFilesInNewWindow这两个设置的语义很直白分别控制“从操作系统层面打开文件夹/文件时是否总是开一个新窗口”。默认值是default意思是让 VS Code 根据上下文自行判断。结果就是你从终端执行code .可能有时开新窗口、有时复用到当前窗口非常迷。如果你被这种“多出一个窗口”的体验困扰建议显式设成off{ window.openFoldersInNewWindow: off, window.openFilesInNewWindow: off }这样外部再点文件夹或文件只要已经有一个 VS Code 窗口在跑内容就会加载到现有窗口里而不是重新弹一个出来。不过这里有个提醒如果你就是想同时打开多个不同项目做对照那就别改这两个保持on反而是你需要的。毕竟多窗口本身不是坏事关键是你能不能控制它。3.3 我常用的“安静启动”配置组合说了这么多我把自己正在用的一套配置直接分享出来。这套配置的特点是启动时完全安静不恢复旧项目、不弹欢迎页、不打开无用的新窗口但保留手动新建窗口的能力。{ window.restoreWindows: none, workbench.startupEditor: none, window.openFoldersInNewWindow: off, window.openFilesInNewWindow: off, window.confirmBeforeClose: false }最后这个window.confirmBeforeClose是我顺手加的作用是关闭窗口之前不弹“确认离开”的提示框省得每次关窗口都要多点一下。如果你觉得误关风险大可以去掉这一行保留默认的确认逻辑。4. 远程开发场景下的隐藏恢复逻辑远程开发现在太常用了Remote-SSH、WSL、Dev Containers 这些插件已经成为不少人日常工作的主力。可远程场景也是“自动打开窗口”问题最容易复发的地方。很多人明明在用户设置里把restoreWindows改成了none结果一启动 VS Code本地没恢复任何窗口远程窗口却自动跑了回来让人怀疑人生。4.1 为什么会复活远程窗口VS Code 在设计远程开发时把“远程窗口”也当成普通窗口来管理。所以在它的窗口恢复系统里远程连接、远程文件夹路径都会被记录下来。如果你上次关 VS Code 时活动窗口是某个 Remote-SSH 窗口那么下次恢复时它优先恢复的就是这个远程窗口而不是本地窗口。更隐蔽的是远程插件还会尝试重新建立 SSH 连接一旦连上整个远程文件树就重新加载出来了。这时候你会觉得“我明明已经关了它怎么又自动连过去了”其实根子还是在窗口恢复机制上。4.2 检查远程配置层级别只改用户配置VS Code 的设置是有层级的用户设置、远程设置、工作区设置一层层往下覆盖。远程设置的优先级高于用户设置。如果你之前不小心在 Remote 配置里写入了window.restoreWindows: all那么就算用户级配置是none远程窗口该恢复还是恢复。排查方法连接上一个远程窗口后按Ctrl,打开设置看看右上角显示的是“用户”还是“远程”作用域。然后搜索restore windows如果远程作用域显示的值不是none把它改过来。最稳妥的办法是把远程作用域里跟restoreWindows相关的值也统一设成none或者直接删除这条覆盖项让它继承用户设置。4.3 远程窗口的“启动时恢复”开关如果你用的是较新版本的 VS Code还可以在远程连接的弹窗里看到“是否在启动时恢复该窗口”之类的确认选项。这个弹窗一般出现在上次远程窗口被异常断开、或者系统重启之后。如果你每次连接都会被这种弹窗打扰可以在远程设置里把对应的remote.restoreWindows相关项关掉。这些设置在官方文档里归类于 Remote 配置你在设置搜索框里输入remote restore就能找到多个相关项。把它们和用户设置统一成none本地和远程窗口就都不再“自动打开”了。5. 你以为关了却还在“自动打开”的几个隐蔽原因设置改对了现象也匹配上了但偏偏还有人发现“有时候还是弹出旧窗口”。这种时候多半不是 VS Code 本身的问题而是周边环境在作妖。我排查这类问题的时候总结出几个特别隐蔽的原因每个都是我或者我帮别人实实在在踩过的坑。5.1 系统级程序恢复把窗口还给了你Windows 和 macOS 都有系统级的“重新打开应用窗口”机制。电脑异常关机、系统更新、或者应用崩溃后系统可能自动把之前打开的应用重新拉起来并且在部分情况下会尝试恢复窗口列表。这时候你要先区分你是“完全退出 VS Code 后手动重启它”还是“系统重启后自动拉起 VS Code”如果是前者那基本锁定 VS Code 内部设置。如果是后者即使 VS Code 内部设置已经是none系统的自动恢复机制也可能绕过设置重新启动应用并尝试恢复窗口。处理办法先把 VS Code 的设置改好再去看操作系统的“登录项”和“恢复窗口”相关设置。Windows 上尽量别拖拽关闭窗口的方式退出程序而是用菜单里的“退出”macOS 上如果总是出现“重新打开窗口”的询问可以在系统设置里关掉针对特定应用的“退出时恢复窗口”权限。具体位置不同系统版本不太一样但逻辑是VS Code 只管自己内部的窗口列表操作系统补刀它拦不住。5.2 快捷键误触导致的“窗口复活”我见过不止一个朋友被CtrlR害过。VS Code 里CtrlRMac 上是CmdR默认绑定的是Reload Window也就是重新加载当前窗口。如果当前窗口里有一些旧状态没有清理干净按一下CtrlR倒是没“恢复旧项目”但当前窗口的所有内容会重新渲染一遍视觉上就跟“自动打开”了一样。更常见的还有CtrlShiftN用得太顺手一不留神就开了一个新窗口新窗口还会沿用之前的状态。这种属于快捷键习惯问题不算配置问题但如果你被频繁打扰可以在快捷键设置里把workbench.action.newWindow改成你几乎不会按到的组合键眼不见心不烦。5.3 多配置文件Profile把设置隔离了VS Code 从 1.x 后期版本开始支持多配置文件Profile。如果你创建过不同的 Profile比如一个“前端开发”Profile、一个“后端开发”Profile那么每个 Profile 可以有自己独立的设置、扩展和窗口状态。问题就来了你在“前端开发”Profile 里改了restoreWindows为none但默认启动用的还是另一个 Profile那个 Profile 的设置压根没动。从用户视角看就是“我改过了怎么还自动打开”。排查方式很简单启动 VS Code 后看左下角或标题栏当前用的是哪个 Profile再进设置里确认当前 Profile 的实际生效值而不是凭记忆判断。5.4 设置同步Settings Sync把你的设置又改回去了多设备用户经常会开 Settings Sync把 VS Code 的配置同步到各台机器上。这本身很方便但如果你在 A 设备上改了某个设置而 B 设备上有一个旧版本的设置在上一次同步中被写回来再经过云端合并很容易出现“改了又被还原”的情况。针对这个坑我建议改完window.restoreWindows这类关键设置后主动到设置同步面板里点一次“上传”或者“合并”确保新值同步到云端。否则它很有可能在下一次同步时被另一台设备的旧配置覆盖掉现象就是“不是我不改是它真的会自己改回来”。6. 最终配置与验证清单照着抄就能解决这一节给你一份可以完全照着抄的收尾方案顺便把前面的内容落到一个可直接复现的流程里。6.1 先按需求选择配置组合你的需求建议配置启动时完全不恢复旧窗口也不要欢迎页window.restoreWindows: noneworkbench.startupEditor: none启动时不恢复旧窗口但喜欢欢迎页入口window.restoreWindows: noneworkbench.startupEditor: welcomePage启动时恢复旧窗口但不想看到欢迎页window.restoreWindows: all或oneworkbench.startupEditor: none希望外部点文件时永远复用当前窗口额外加上window.openFoldersInNewWindow: offwindow.openFilesInNewWindow: off把选好的配置写进用户settings.json注意配置文件里的 JSON 语法逗号和引号一个都不能少。6.2 验证步骤清单改完配置之后我建议你做一轮标准验证确保不是“感觉好了其实没验证”打开一个项目再故意开几个标签页和一个终端。通过菜单“文件”里的“退出”完全退出 VS Code不要在 Windows 上直接点右上角 X也不要只重载窗口。重新启动 VS Code。观察是否还有旧标签页、旧终端和旧文件夹恢复。用一个与 VS Code 无关的文件管理器双击一个代码文件确认它是在现有窗口打开而不是弹新窗口。如果你用 Remote-SSH再打开一次远程连接确认远程窗口没有在本地启动时被自动拉回来。这套验证流程走到最后一步基本能确保所有“自动打开窗口”的行为都被你拿捏住了。6.3 我踩过的坑顺便说给你听第一次我改完window.restoreWindows发现没生效折腾半天才发现我只是用CtrlR重新加载了窗口而压根没有真正退出 VS Code。在 Windows 上点掉所有窗口不代表进程结束托盘区可能还留着 VS Code 的残留进程设置不会立即生效。Mac 上也是Dock 里图形还亮着说明进程没退干净。所以凡是改完这类启动相关设置第一步一定是彻底退出进程再重新打开这一步能解决掉一半的“设置无效”。另外如果你是用公司电脑办公并且组策略或管理员配置锁定了某些设置那settings.json里就算写了也读不进去。遇到这种环境别硬刚看看设置界面里有没有“此设置已由管理员配置”的提示。有就说明机关在管理员那一层自己这台机器怎么改都没用。最后分享一个我自己的习惯我会把窗口行为相关的设置集中写在一个 JSON 片段里并在旁边加注释说明这组配置是“安静启动模式”。以后哪天不想用这套逻辑了删掉这个片段就行找起来非常省事。VS Code 里跟“自动打开窗口”有关的设置其实就那么几个只要你分清现象、找对设置、再彻底重启一遍这问题真不算事。