VSCode命令行启动_使用命令行参数启动VSCode

code命令路径参数须为绝对路径或当前目录下相对路径，tilde路径不被解析，–wait需配合–new确保阻塞，-r复用窗口但多根工作区易混淆，调试参数可通过process.argv或argv.json查看。

用 code 命令启动 vscode 时，路径参数必须是绝对路径或当前工作目录下的相对路径

VSCode 安装后会把 code 命令注册到系统 PATH（macOS/linux 需手动运行 Shell Command: Install 'code' command in PATH），但很多人执行 code ./src 却打开空白窗口或报错，本质是当前 shell 的工作目录没对准。VSCode 不会自动解析类似 ~/project 这样的 tilde 路径，也不会帮你 cd 到项目根目录。

• ✅ 正确做法：先 cd /full/path/to/project，再运行 code .
• ❌ 错误写法：code ~/my-project（bash/zsh 下 tilde 不会被 code 解析）
• ⚠️ 注意：windows PowerShell 中 code .src 可行，但 CMD 下推荐用正斜杠或绝对路径，避免反斜杠转义问题

code --wait 在脚本中阻塞执行，但只对首次调用生效

当你在 Shell 脚本或 git hook 中用 code --wait 编辑文件并等待保存关闭后再继续，它确实会暂停脚本执行——但前提是 VSCode 实例尚未运行。如果后台已有 Code 进程，--wait 会立刻返回，不等你编辑完。

• ✅ 确保阻塞行为：加 --new 参数强制新开实例，例如 code --new --wait file.txt
• ❌ 不加 --new 时，若已有窗口，--wait 形同虚设
• ? 补充：配合 --diff 时 --wait 依然有效，适合写 pre-commit diff 工具

用 code -r 复用已有窗口，但多根工作区下行为有歧义

-r（--reuse-window）让新命令复用最近激活的窗口，而不是总开新窗。这在日常开发中省事，但在打开不同工作区（尤其是含多个文件夹的 .code-workspace）时容易串项目。

• ✅ 明确指定目标窗口：用 code -r --folder-uri file:///full/path/to/folder
• ❌ 直接 code -r ./other-project 可能仍聚焦旧窗口，且不切换工作区
• ⚠️ 兼容性注意：windows 上 file:// URI 必须双斜杠 + 盘符大写，如 file://C:/project；Linux/macOS 用 file:///home/user/project

调试启动参数：如何查看 VSCode 实际接收了哪些命令行参数

VSCode 启动后不会直接暴露传入的原始参数，但可通过开发者工具快速验证。尤其当配置了自定义 argv.json 或遇到插件读取参数失败时，这是最直接的排查方式。

• ✅ 打开 DevTools：菜单 Help → Toggle Developer Tools，然后在 console 输入 process.argv
• ✅ 查看 argv.json：VSCode 启动时会读取 $HOME/.vscode/argv.json（macos/Linux）或 %appDATA%Codeargv.json（Windows），里面记录了持久化参数
• ⚠️ 注意：argv.json 中的 enable-crash-reporter 或 disable-extensions 会覆盖命令行参数，优先级更高

process.argv // 输出示例（简化）： [   "/Applications/Visual Studio Code.app/Contents/MacOS/Electron",   "--skip-getting-started",   "--folder-uri",   "file:///Users/me/project",   "--goto",   "src/index.ts:42" ]

命令行参数的组合逻辑并不线性，尤其在复用窗口、多工作区、远程开发（code --remote ssh-remote+host）场景下，实际行为常取决于已有进程状态而非单条命令本身。