必须先注册code命令：macos通过cmd+shift+p执行“shell command: install 'code' command in path”，windows安装时需勾选“add to path”；路径含空格须加引号，定位语法为file:line:col。
vscode 命令行启动的基本前提
必须先在系统中注册 code 命令，否则所有后续操作都会报 command not found: code。macOS 和 Windows（通过 VS Code 安装器）默认不自动添加该命令，需手动启用：macOS 在 VS Code 窗口里按 Cmd+Shift+P，输入 “Shell Command: Install ‘code’ command in PATH” 并执行；Windows 需勾选安装时的 “Add to PATH” 选项，或重装并确认勾选。
打开单个文件的正确写法
最常用也最容易出错的是路径空格和相对路径处理。直接运行 code index.html 可以工作，但若当前目录下没有该文件，VS Code 会新建一个空白文件——这不是报错，而是静默创建，容易误以为打开了已有文件。
- 用绝对路径更可靠：
code /Users/you/project/src/main.js - 路径含空格时，必须加引号：
code "./my project/app.ts"（单引号或双引号均可） - 想强制打开已有文件、不新建，可加
-r（reuse window）参数：code -r package.json
常见错误：-w 参数导致终端卡住
很多教程推荐加 -w（wait）让命令阻塞，等编辑器关闭后再返回终端。但实际中，它常引发两个问题：一是 VS Code 启动慢时终端长时间无响应；二是如果文件被外部修改过，VS Code 弹出保存提示，-w 会一直等待用户操作，彻底卡死脚本流程。
- 交互式使用可保留
-w，但自动化脚本中应避免 - 替代方案是用
code --new-window显式控制窗口行为，比-w更可控 -
-n（new window）和-r（reuse）互斥，同时出现时后者优先
打开文件并跳转到指定行/列
VS Code 支持行号和行列定位，但语法有固定格式，且不支持任意分隔符。错误写法如 code app.js:10 或 code app.js#L10 都无效。
- 正确格式是：
code app.js:10:5（第 10 行第 5 列），行号必填，列号可省略 - 只跳转行：
code app.js:42 - 该功能对未保存的临时文件也生效，但若文件不存在，仍会新建空文件再跳转
-r 和 -n 的行为差异、-w 的阻塞特性，很容易变成半夜排查的隐性坑。
