code命令不可用是因未注册PATH,需在VSCode中执行“Shell Command: Install 'code' command in PATH”并重启终端;code .默认复用窗口,必须加--new-window才能新开独立工作区。

code . 能直接打开当前目录为工作区,但必须先让 code 命令可用,否则所有操作都卡在第一步。
code 命令根本没反应?先确认 CLI 是否注册成功
执行 code --version 是最直接的验证方式。如果报错 command not found: code,说明 VS Code 的命令行工具压根没写入系统 PATH —— 这和路径拼写、权限、Shell 类型都无关,纯属注册步骤被跳过。
- 在任意已打开的 VS Code 窗口中按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS) - 输入并运行
Shell Command: Install 'code' command in PATH - 关掉所有已打开的终端窗口(CMD、PowerShell、iTerm2、Terminal.app 等),**新开一个终端**再试
code --version - macOS 用户尤其注意:即使 App 已安装,
code默认不可用;Windows 便携版、企业策略禁用、重装时未勾选“Add to PATH”都会导致这一步失败
code . 总在旧窗口里打开?必须加 --new-window
code . 默认复用已有 VS Code 窗口,这是设计行为,不是 bug。如果你想要一个干净、独立、以当前目录为根的工作区窗口,漏掉 --new-window 就等于白写。
- 正确写法只有这一种:
code --new-window . - 点号
.表示当前终端所在目录,不能省略或替换成空格 - 末尾加斜杠(如
code --new-window ./)可能触发“No folder opened”错误 - 路径含中文、空格、符号链接都没问题,VS Code 会原样加载,不自动解析真实路径
- 常见现象:执行后左下角仍显示上一个工作区路径,或资源管理器里多出一个子文件夹 —— 这就是没加
--new-window的典型表现
终端打开了但 pwd 不对?优先级比配置项还高
VS Code 终端的初始工作目录不是靠 terminal.integrated.cwd 配置项“决定”的,而是按固定顺序匹配,配置项只是兜底选项。
- 最高优先级:右键资源管理器中某个文件夹 → 在集成终端中打开
- 次高:已打开工作区的根目录(即
code --new-window .启动的那个目录) - 再次:当前编辑文件所在目录(
${fileDirname}) - 最后才轮到
terminal.integrated.cwd配置值(如"${workspaceFolder}"或"${fileDirname}") - 工作区级设置(
.vscode/settings.json)比用户级设置优先级更高,适合项目定制
想让终端总在当前文件目录启动?别只改配置
设 "terminal.integrated.cwd": "${fileDirname}" 看似合理,但实际效果受限于“是否已打开工作区”。如果只是双击打开单个 index.js,VS Code 会以该文件所在深路径为起点,后续所有终端都继承这个非根路径,容易引发构建失败或依赖解析异常。
- 真正可靠的做法:始终用
code --new-window .打开整个文件夹,确保工作区根目录明确 - 再配合
"terminal.integrated.cwd": "${workspaceFolder}",终端就永远从项目根开始 - 若真需单文件上下文(比如跑一个临时脚本),右键文件 → 在终端中显示,它会自动执行
cd到对应目录,比配置更精准 - 注意:每个终端标签页都是独立进程,
cd或export不会跨标签页继承
最容易被忽略的是:VS Code 启动时的路径和终端启动时的路径是两套逻辑,前者由 code 命令参数决定,后者由工作区上下文 + 右键操作 + 配置项三级叠加决定。混用 code . 和双击文件,会让这两条线彻底脱节。











