code命令不可用需先手动注册到PATH：在VS Code中执行Shell Command: Install 'code' command in PATH；再用code --version验证，之后才能使用code .、--wait、--list-extensions等全部功能。
code 命令根本用不了？先确认它是否真在 PATH 里
输 code --version 报 command not found，不是终端坏了，是 code 命令压根没注册进系统路径。VS Code 官方安装包默认不自动加 PATH，必须手动触发注册。
操作路径唯一有效：打开 VS Code 图形界面 → 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入并执行 Shell Command: Install 'code' command in PATH。
注意几个硬限制：
- 该操作只对当前用户生效，不会影响其他账户
- 依赖 VS Code 自带的 shell 包装器（如 macOS 上位于
/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code），.zip 解压版、Snap、Flatpak 等非官方分发渠道通常不带这个包装器，命令不可用 - Windows 用户若初装时没勾选 “Add to PATH”，需手动把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量 - 改完 PATH 后，旧终端窗口不会自动更新，必须新开一个终端再试
code . 打不开当前目录？参数和路径细节决定成败
code . 表面简单，但实际行为受参数控制，且对路径敏感。常见问题不是命令失败，而是开错窗口或跳转失效。
典型场景和对应写法：
- 想复用已有窗口打开当前项目：用
code -r .（-r=--reuse-window），避免每次code .都弹新窗口 - 想强制新建独立窗口（比如对比两个项目）：用
code -n .（-n=--new-window） - 路径含中文或空格（尤其 Windows）：必须加双引号，例如
code ".\my project"，否则 shell 解析失败 - 想打开文件并跳到某行某列：用
code -g main.js:42:8，-g是--goto的简写
别依赖记忆——不确定时直接敲 code --help 看参数列表，比查文档快。
脚本里调用 code 命令卡住或失败？注意阻塞与环境隔离
在 shell 脚本、Makefile 或 cron 任务中调用 code，容易遇到两种典型问题：命令立即返回但编辑器没起来，或者根本报错说找不到 GUI 环境。
关键点在于：
-
code默认是非阻塞的，脚本会继续往下跑。需要等待编辑器关闭再继续，得加--wait参数，例如code --wait settings.json - cron、systemd service 或远程 SSH 会话通常没有 DISPLAY 或 GUI session，
code会静默失败。此时应改用无界面命令，比如code --list-extensions或code --install-extension ms-python.python - 脚本中不要依赖相对路径或未初始化的 shell 配置。建议用绝对路径调用，例如
/usr/local/bin/code（macOS/Linux）或"C:\Users\name\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd"（Windows）
code 命令能干的不只是打开文件夹
很多人只知道 code .，其实 code 是个功能完整的 CLI 工具，日常维护效率很高。
高频实用组合：
- 批量管理扩展：
code --list-extensions查已装列表，code --install-extension esbenp.prettier-vscode装指定扩展，code --uninstall-extension redhat.vscode-yaml卸载 - 诊断环境问题：
code --status输出当前窗口的进程、GPU、扩展加载状态，比看日志快得多 - 临时禁用干扰：
code --disable-extensions .启动时不加载任何扩展，排查插件冲突很管用 - 对比文件差异：
code --diff file1.txt file2.txt直接唤起内建 diff 视图，不用切到 GitLens
真正容易被忽略的是：这些命令不依赖 VS Code 图形界面是否已运行，只要 code 在 PATH 里，就能在任意终端中执行。但反过来，如果 PATH 没配好，连 code --list-extensions 都会失败——所有高级用法都建立在基础注册成功之上。
