vscode命令行打开文件需确保code已加入path，路径必须真实存在且推荐用绝对路径；打开目录默认新建窗口，加-r复用已有实例；参数须前置，多路径支持，wsl等远程场景需通过remote扩展调用。
vscode 命令行打开单个文件时路径必须存在
如果 code 命令报错 command not found，说明 VSCode 的命令行工具没启用——不是安装问题，而是没在系统 PATH 中注册。macOS 和 Windows 都需要手动启用一次：打开 VSCode → Command Palette（Cmd+Shift+P）→ 输入 “Shell Command: Install 'code' command in PATH” → 回车执行。
打开文件本身很简单：code /path/to/file.js。但要注意：路径必须真实存在，且不能是相对路径中的未解析符号（比如 code ~/src/app.ts 在某些 shell 下可能不展开 ~，建议用绝对路径或先 cd 进入目录再用 code file.ts）。
常见错误现象：
-
Unable to open '/xxx': File not found—— 路径拼写错误，或当前 shell 没有权限读取该路径 -
code: command not found—— 未运行 Shell Command 安装步骤 - 打开后显示空白或乱码 —— 文件编码异常，可加
--encoding utf8强制指定
vscode 打开整个项目目录时默认启动新窗口
执行 code /path/to/project 默认会新开一个独立窗口，即使已有 VSCode 实例在运行。这容易导致多个编辑器窗口并存、扩展重复加载、设置不同步等问题。
想复用已有窗口，加 -r（reuse）参数：code -r /path/to/project。这个参数只对目录有效，对单个文件无效。
使用场景差异：
- 开发中频繁切换子模块：用
code -r ./packages/ui复用主窗口，避免窗口泛滥 - 临时查看配置文件：直接
code .eslintrc.cjs，无需-r - 想强制新建窗口（比如对比两个分支）：显式加
-n，code -n ./legacy-branch
注意：-r 不会自动关闭旧工作区，只是把新目录作为新标签页或新窗口组加入当前实例。
vscode 命令行传参顺序影响行为逻辑
code 命令的参数顺序不是随意的。例如 code -r -n . 会以 -n 为准（新建窗口），因为后者覆盖前者；而 code -n . -r 会报错：未知参数 -r，因为 code 只识别位置靠前的有效开关，后面多余的会被忽略或报错。
关键规则：
- 所有开关（
-r、-n、--wait等）必须放在路径之前 - 多个路径同时打开：
code -r file1.ts file2.ts ./src，会全部加载进同一个窗口的工作区 -
--wait必须配合文件/目录使用，否则无意义；它让终端阻塞，直到编辑器关闭该文件才返回控制权，适合脚本中做串行编辑 - Windows 上路径含空格必须用双引号包裹：
code -r "C:\My Project\src"
vscode 命令行打开远程或 WSL 项目要绕过路径映射
在 WSL 中执行 code /home/user/project，VSCode（Windows 版）无法直接访问 Linux 路径。此时会报错或打开空白窗口。正确做法是用 VS Code Remote - WSL 扩展，然后在 WSL 终端里运行：code . —— 这会触发远程连接，而不是试图用本地 VSCode 打开。
同理，SSH 或 Dev Containers 场景下，不要在本地终端跑 code user@host:/path，那是无效的。必须先连接目标环境，再在目标终端内调用 code。
容易被忽略的一点：WSL 中的 code 命令不是系统自带的，而是 VS Code 自动注入到 WSL PATH 中的代理脚本，首次使用需确保已安装 Remote - WSL 扩展，并重启 WSL（wsl --shutdown 后再打开）。否则 code 命令根本不存在。
