code --version无输出说明cli未注册，需在vs code中执行“shell command: install 'code' command in path”并重启终端；code .默认复用窗口，必须加--new-window才新开；路径含空格无需引号，但末尾斜杠或符号链接可能导致“no folder opened”。
code 命令根本没反应？先确认它是否真的可用
执行 code --version 是最直接的验证方式。如果报错 command not found: code，说明 CLI 工具压根没注册进系统 PATH —— 这不是路径写错了，也不是权限问题，而是 VS Code 的命令行支持根本没启用。
解决方法唯一且明确：
- 在任意已打开的 VS Code 窗口中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并运行
Shell Command: Install 'code' command in PATH - 关掉所有终端窗口，**重新打开一个新终端**（PATH 变更不会生效于已有终端）
- 再试
code --version，有输出即成功
macOS 用户尤其注意：即使 VS Code 已安装，code 命令默认也不可用，必须走这一步；Windows 用户若用的是便携版、企业策略禁用或重装跳过了勾选，也会遇到同样问题。
code . 为什么总在旧窗口里打开？加 --new-window 才算真正“新”
code . 默认复用已有窗口，这是 VS Code 的单实例行为，不是 bug，但不符合“启动新窗口”的实际需求。要强制新开独立进程和窗口，必须显式带上 --new-window 参数。
正确写法只有这一种：
-
code --new-window .—— 在当前终端所在目录启动干净新窗口，并自动打开该文件夹 -
--new-window不可省略，漏掉就等于没写 - 点号
.表示当前目录，也不能省；换成空格或留空会导致打开空白窗口 - 如果当前是 Git 子模块或符号链接目录，VS Code 会如实加载该路径，不自动解析为真实路径
常见错误现象：code . 执行后，目标文件夹被塞进已有窗口的资源管理器里，左下角仍显示 “No folder opened” 或上一个工作区路径 —— 这就是没加 --new-window 的典型表现。
路径写错、带斜杠、含空格？这些细节真会影响打开结果
VS Code 对路径解析很实在，但有几个边界情况容易踩坑：
- Windows 下推荐用正斜杠：
code C:/Users/me/project，VS Code 内部自动兼容；若坚持用反斜杠，必须双写：code C:\Users\me\project，单个会被 shell 当转义符吃掉 - 路径末尾多加斜杠（如
code C:/project/）可能触发解析异常，导致窗口打开但左侧资源管理器为空 - 路径含空格无需引号：
code C:/My Projects/app是合法的，VS Code 自己做了处理 - 符号链接、网络映射盘（Z:）、UNC 路径（
\servershare）在某些 VS Code 版本中支持不稳定，打开后可能出现 “No folder opened” 提示
验证是否真打开了文件夹：看左下角状态栏 —— 显示具体路径才算成功；如果还是 “No folder opened”，说明只是弹了个编辑器，不是工作区窗口。
需要等 VS Code 关闭后再继续执行后续命令？用 --wait
脚本中常需要 “打开 VS Code → 编辑完 → 关掉 → 继续跑下一步”，这时候 --wait 就关键了。它会让终端阻塞，直到 VS Code 窗口被手动关闭才返回控制权。
典型组合用法：
-
code --new-window --wait .：开新窗口、打开当前目录、等你关掉再继续 -
code --wait --diff file1.txt file2.txt：对比两个文件，关闭对比窗口后终端才放行 - 注意：
--wait必须和--new-window配合使用才可靠；单独code --wait .仍可能复用旧窗口，导致等待逻辑失效
这个参数在自动化流程（比如 CI 后打开日志目录检查、生成报告后人工审核）里非常实用，但容易被忽略 —— 很多人卡在“命令飞快执行完，根本没等我操作”上，其实就差这一个 flag。
