code命令输不进去是因为未注册到PATH，需在VSCode图形界面中执行Shell Command: Install 'code' command in PATH并重启终端；.zip、Snap等非官方版本不支持该命令，须换用官网正式安装包。
code 命令为什么输不进去？
不是环境变量没配好，是根本没注册。VSCode 官方安装包默认不把 code 命令写入系统 PATH，哪怕你重装十次，终端里敲 code --version 依然报 command not found。
必须手动触发注册流程：
- 打开 VSCode 图形界面（不能只靠命令行）
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Shell Command: Install 'code' command in PATH，回车执行 - 关闭并重新打开终端（旧终端不会自动加载新
PATH）
注意：.zip 解压版、Snap/Flatpak 包、ARM64 非官方镜像通常不支持该命令——得换用官网下载的正式安装包。
code . 打不开当前目录？常见卡顿和闪退原因
现象是窗口一闪而过，或 PowerShell 报错 The term 'code' is not recognized，本质是路径解析失败或权限拦截。
排查要点：
- Windows 上确认是否勾选了安装时的
Add to PATH；若没勾，需手动把C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量 - 路径含中文或空格时，必须用双引号包裹：
code ".\my project"，否则 Windows Shell 会截断参数 - PowerShell 默认策略禁止脚本执行，运行一次
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户） - Linux/macOS 下如果用 zsh，检查
~/.zshrc是否漏 source 了 PATH 更新（注册后通常会自动追加一行）
启动参数怎么选才不弹一堆窗口？
code . 每次都开新窗口，项目一多就失控。关键在参数控制复用行为：
-
code -r .：强制复用已有窗口（-r=--reuse-window），适合日常开发 -
code -n .：强制新建窗口（-n=--new-window），适合对比不同分支或项目 -
code -w .：阻塞等待（-w=--wait），脚本中调用时防止后续命令提前执行 -
code --disable-extensions .：临时禁用所有扩展，排查插件冲突时用
别混用 -r 和 -n，它们互斥；也别在自动化脚本里漏掉 -w，否则 shell 会立刻返回，无法感知编辑器是否已就绪。
脚本里调用 code 命令要注意什么？
在 CI/CD、Makefile 或 shell 脚本里用 code，最容易踩两个坑：GUI 环境缺失、路径不绝对。
真实场景限制：
- Linux 下 cron 或 systemd service 中执行
code .必然失败——没有 DISPLAY 或 Wayland socket，得换code --list-extensions这类无界面命令 - 脚本中别写相对路径如
code src/，要用code "$(pwd)/src/"或code "${PWD}/src/"，避免因工作目录变更导致打开错位置 - macOS 上如果用 launchd 启动脚本，PATH 不继承 GUI 环境，得显式指定
/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code
最稳的做法：先用 which code 或 command -v code 检查命令是否存在，再执行，别假设它一定在 PATH 里。
