code命令报“command not found”本质是未注册进系统PATH：macOS/Linux需通过命令面板执行“Shell Command: Install 'code' command in PATH”并重启终端；Windows需安装时勾选Add toPATH或手动添加bin路径到环境变量。
code 命令在终端里报 command not found，不是 VS Code 没装好，是它根本没注册进系统 PATH —— 这一步跳过，后面所有命令行操作都白搭。
先验证 code 是否真可用
别猜，直接测：
- 打开终端（macOS/Linux 用 Terminal，Windows 用 PowerShell 或 CMD）
- 运行
code --version - 有输出版本号（如
1.94.2），说明已就位；若提示command not found或The term 'code' is not recognized，立刻停手，别试code .或参数，先修这个
macOS/Linux：用 Shell Command 一键注册最稳
图形界面启动 VS Code → Shift+Cmd+P（macOS）或 Ctrl+Shift+P（Linux）→ 输入 Shell Command → 选中并执行 Shell Command: Install 'code' command in PATH。
关键细节：
- 执行后会弹提示，但**必须关闭当前终端、新开一个**，PATH 才生效
- 如果报
EACCES: permission denied，先运行Shell Command: Uninstall 'code' command from PATH，再重装 - 手动改
.zshrc或.bashrc是备选方案，路径要写对：export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH"，且必须source ~/.zshrc
Windows：安装时勾选 or 手动加 PATH
安装包默认不勾选 Add to PATH，这是绝大多数问题的根源。
补救方式：
- 查 VS Code 实际安装路径：CMD 里运行
where code，常见位置是C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin - 把这个完整路径（注意是
bin目录，不是Code.exe所在目录）加到系统环境变量Path中 - 加完必须重启终端，且推荐**重启 VS Code 本身**——某些插件初始化依赖启动时读取的 PATH
WSL 用户特别注意：code . 在 WSL 终端里必然失败，那是 Windows 主机上的命令；要用 Remote - WSL 扩展，它会自动转发请求。
--user-data-dir 和 --extensions-dir 不是 PATH 问题，别混
有人把 code --user-data-dir="/my/config" 当成修复 PATH 的手段，这是误解。这两个参数只影响配置/扩展存放位置，和 code 命令能否被识别完全无关。
它们生效的前提是：code 命令本身已在 PATH 中可用。否则你会得到同样的 command not found 错误，参数根本没机会解析。
真正容易被忽略的点：PATH 修改后，VS Code 图形界面和终端继承的环境变量可能不同步。比如你改了系统 PATH，但 VS Code 内置终端仍看不到 Git，就得单独配 terminal.integrated.env.windows —— 但这已是 PATH 修复后的第二层问题。
