code --new-window . 是最直接可靠的命令,在当前目录启动干净新 VS Code 窗口并打开该文件夹,不复用旧进程;需显式带 --new-window 参数和点号 .,macOS 需先通过命令面板安装 code 命令至 PATH。

直接用 code --new-window .,当前目录开新窗口最稳,不复用、不依赖设置、不看 GUI 状态。
为什么 code . 总是在旧窗口里打开?
这是 VS Code 默认行为(单实例模式),不是 bug。它会找最近活跃的窗口并复用,code . 本质等价于 code --reuse-window .。想开新窗口,必须显式加 --new-window 或简写 -n。
-
code .→ 复用已有窗口(哪怕你刚关掉一个) -
code --new-window .→ 强制启动新进程、新窗口、新工作区 - 漏掉
--new-window就等于没写这个需求 - 点号
.表示当前目录,不能省略;空格或无参数会打开空白窗口,但不加载当前路径
macOS/Linux 下 code 命令根本不存在?
不是权限问题,是 PATH 没注册。VS Code 官方安装包自带的 CLI 工具默认不进系统路径,必须手动触发注册。
- 打开任意 VS Code 窗口,按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Linux/Windows) - 输入并运行
Shell Command: Install 'code' command in PATH - 关闭并重开终端,再试
code --version - 别手动改
PATH或软链——VS Code 会根据 shell 类型(zsh/bash/fish)自动写入正确配置 - .zip 解压版、Snap/Flatpak 包不支持该命令,得换官方 dmg/deb 安装包
Windows 上 code --new-window . 一闪而过或报错?
常见于两种情况:PATH 未生效,或路径含空格/中文未加引号。
- 确保已执行过
Shell Command: Install 'code' command in PATH,且重启了 PowerShell/CMD(旧窗口不会自动 reload PATH) - 初装时若没勾选 “Add to PATH”,需手动把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加入系统环境变量 - 路径含空格或中文时,必须用双引号包裹:
code --new-window ".\my project",否则 Windows 命令解析失败 - PowerShell 中若提示
The term 'code' is not recognized,大概率是执行了安装命令但没重启终端
真正容易被忽略的是:新窗口 ≠ 新进程 ≠ 新环境变量。比如用 conda 环境,conda activate my_env && code --new-window . 才能保证 Python 解释器识别正确;分开两行执行,子进程根本收不到激活后的环境。


















