code命令默认不可用是因为安装包未自动将其写入PATH，需通过VS Code图形界面执行“Shell Command: Install 'code' command in PATH”手动注册，macOS/Linux会创建软链接并更新shell配置，Windows需安装时勾选Add to PATH或手动添加。
code 命令在 macOS/Linux 上默认不可用，Windows 上也可能失效——这不是环境变量没加载对，而是根本没注册进系统 PATH。
为什么 code 命令在终端里报 “command not found”
VS Code 安装包（.dmg、.deb、.exe）自带一个 shell 包装器 code，但它不会自动写入 $PATH。你打开终端输 code --help 失败，不是 shell 配置错了，是这个二进制压根没被系统看见。
- macOS/Linux：必须通过 VS Code 图形界面触发
Shell Command: Install 'code' command in PATH，它会把/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code（macOS）或/usr/bin/code（Linux deb 包）软链到~/bin/或/usr/local/bin/，并更新当前用户的 shell 配置文件（如~/.zshrc） - Windows：安装时若没勾选
Add to PATH，则code不会被写入系统或用户环境变量；手动添加需指向C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin - .zip 解压版、Snap/Flatpak 版本不提供该命令注册功能——它们没有包装器，
code命令天然不存在
code 命令启动时窗口一闪而过或打不开目录
常见于 Windows PowerShell/CMD 中运行 code . 后无响应，本质是 GUI 环境缺失或路径解析失败。
- 确保已执行
Shell Command: Install 'code' command in PATH，且重启了终端（旧终端不会重载 PATH） - 路径含空格或中文时，必须用双引号包裹：
code ".\my project"，否则 Windows 下参数截断导致启动失败 - 在无桌面会话的环境（如 SSH 连入的 Linux 服务器、cron 任务）中，
code无法启动 GUI 窗口；此时应改用code --list-extensions等无界面命令，或用绝对路径调用/usr/share/code/bin/code并确认 DISPLAY 变量已设
跨平台脚本中安全调用 code 命令的关键参数
不同系统下 code 行为差异集中在窗口复用和阻塞逻辑，硬编码参数易导致 CI 或本地自动化失败。
-
-r（reuse window）：强制复用已有窗口，避免每次打开新实例；macOS/Linux 下稳定，Windows 上某些版本有窗口焦点异常问题 -
-n（new window）：显式新建窗口，适合并行调试多个项目，但注意 Windows 上可能触发 UAC 提权弹窗 -
-w（wait）：脚本中需等待编辑器关闭再继续执行（如code -w . && npm run build），但仅在 CLI 模式下生效；GUI 启动时该标志被忽略 - 避免用
-g跳转到行号列号（如code -g main.cpp:10:5）做跨平台自动化，因不同语言扩展对定位的支持不一致；优先用${file}:${line}:${column}变量在 tasks.json 中处理
真正跨平台的启动逻辑，不在于参数多花哨，而在于先确认 code 是否存在、是否支持当前上下文。脚本开头加一句 command -v code >/dev/null 2>&1 || { echo "code command not available"; exit 1; }，比任何参数适配都实在。
