code --new-window 是打开真正独立窗口的唯一可靠方式,它强制启动新进程并加载指定文件夹,绕过VSCode默认复用窗口逻辑;若需物理级隔离,还必须配合--user-data-dir参数指定不同用户数据路径。

code --new-window 是打开新窗口的唯一可靠方式
VSCode 默认复用已有窗口,code --new-window 是绕过所有自动合并逻辑、强制启动新进程的唯一命令级保障。它不依赖设置、不看快捷键是否被劫持,适合脚本、终端党或 GUI 失效时兜底。
-
--new-window必须显式写出,漏掉就等于没写——code .会复用最近窗口,不是 bug,是默认行为 - 路径必须跟上,不能只写
code --new-window(会弹空窗口但无法加载项目);常用写法是code --new-window ./my-project或code --new-window . - macOS 用户首次执行前需先在 VS Code 中运行
Shell Command: Install 'code' command in PATH,否则报command not found: code - Windows/Linux 若快捷键
Ctrl+Shift+N失效(常见于远程桌面、输入法或键盘固件冲突),命令行是唯一稳定入口
为什么 -n 参数有时不生效?
-n 是 --new-window 的简写,功能完全等价,但部分旧版本或非标准 Shell 环境下解析不稳定。更关键的是:如果设置了 "workbench.preferredNewWindowMode": "on",VSCode 会优先走这个配置并忽略 --new-window 参数。
- 检查
settings.json是否存在该配置项,有则删掉或设为"default" -
-n和--new-window都不能绕过window.openFoldersInNewWindow的全局开关逻辑——它只影响 GUI 行为(如 Dock 右键、最近文件夹列表),不影响命令行参数 - 若想确保“物理隔离”,仅靠
--new-window不够,还需配合--user-data-dir指定独立用户数据路径,否则两个窗口仍共享扩展启用状态、终端历史和调试断点
打开单个文件时怎么进新窗口?
VSCode 命令行对单文件和文件夹的处理逻辑不同:code --new-window some-file.js 会启动新窗口但只打开该文件,不会加载其所在文件夹的 .vscode/settings.json 或项目级扩展配置——这常导致 ESLint、TypeScript 路径别名等失效。
- 正确做法是先进入文件所在目录,再执行
code --new-window .,让整个项目上下文生效 - 若真要打开单文件且进新窗口,可用
code --new-window /full/path/to/file.js,但务必用绝对路径(~/波浪线不支持) -
--read-only可与--new-window组合使用,比如code --new-window --read-only /etc/hosts,防止误改系统文件
多项目并行时容易忽略的关键点
很多人以为开了多个 --new-window 窗口就天然隔离了,其实不然。VSCode 默认所有窗口共用同一套用户数据目录(User Data),包括扩展启用状态、快捷键绑定、终端历史、甚至 Copilot 会话缓存。
- 真正隔离必须加
--user-data-dir,例如code --user-data-dir="/tmp/vscode-a" --new-window ./project-a - 该路径必须为空或不存在,否则 VSCode 会复用其中的插件启用记录;指向已有目录 ≠ 新实例
- 不要信 “Add Folder to Workspace”——它只是生成多根工作区(
.code-workspace),所有项目仍在同一窗口、同一进程里,Git 配置、Node 版本、ESLint 规则全共享 - 右键菜单没有“在新窗口中打开”选项,这是官方未内置的功能,不是你装错扩展或配置漏了











