code命令不可用是因为VS Code的Shell Command未安装，必须通过Ctrl+Shift+P运行“Shell Command: Install 'code' command in PATH”启用；且需重启终端生效。

code 命令根本没反应？不是路径错了，是 CLI 工具压根没注册进 PATH —— 必须手动启用，否则所有后续操作都无效。

code 命令不可用：Shell Command 未安装是唯一原因

执行 code --version 无输出或报 command not found: code，说明 VS Code 的命令行支持尚未启用。这不是环境变量配置问题，也不是权限问题，而是 VS Code 自身的 CLI 功能默认关闭。

• 在任意已打开的 VS Code 窗口中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）
• 输入并运行 Shell Command: Install 'code' command in PATH
• **必须关闭所有终端窗口，再新开一个**——已有终端不会自动加载更新后的 PATH
• macOS 用户尤其注意：即使从官网下载安装，code 命令也默认不可用，这步不可跳过
• Windows 便携版、企业策略禁用、或安装时取消勾选“Add to PATH”，都会导致此问题

code . 总复用旧窗口？--new-window 是硬性要求

code . 默认复用已有 VS Code 实例，这不是 bug，但和“启动新窗口”的实际意图冲突。不加参数就等于白写。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 正确写法只有：code --new-window .（当前目录启动干净新窗口）
• --new-window 不可省略；点号 . 表示当前目录，也不能省
• 如果目标是子模块或符号链接目录，VS Code 不会自动解析真实路径，它就认你写的字面路径
• 常见错误现象：code . 执行后左下角仍显示 “No folder opened” 或上一个工作区路径 —— 这就是漏了 --new-window

路径含空格、波浪线或斜杠？别猜，要明确处理

VS Code 的 code 命令不解析 ~，也不自动切换工作目录，路径必须准确且符合 shell 规则。

• 最稳做法：先 cd 到目标目录，再执行 code .
• 用绝对路径：Linux/macOS 写 code /home/user/my-project，Windows 写 code C:\Users\user\my-project
• 路径含空格或中文：必须加双引号，如 code "./my project"
• Windows PowerShell 中 code .\src 可行，但 CMD 推荐用正斜杠：code ./src，避免反斜杠被转义
• 末尾带斜杠（如 code ./src/）或符号链接路径，可能触发 No folder opened 错误

--wait 参数只在首次启动时阻塞终端

--wait 看似能“等编辑完再返回”，但它有严重限制：仅对第一个 VS Code 进程有效。

• 如果后台已有 code 进程在运行，code --wait . 会立刻返回，根本不会等待你保存或关闭
• 它不是进程级同步机制，只是启动时的临时阻塞信号
• 需要真正阻塞流程的场景（如脚本中依赖编辑完成），得配合 pgrep 或 ps 检查进程是否存在，不能只信 --wait
• 调试或自动化任务中，更可靠的做法是用 code --new-window --wait . + 显式 kill 进程，而非依赖单一参数

真正容易被忽略的是：PATH 更新后终端不重启就无效，以及 --wait 在多实例下的失效逻辑 —— 这两个点一旦出错，整个自动化链路就断在看不见的地方。