vs code 的 code 命令未找到是因安装时未勾选“add to path”或使用免安装版；应通过官方方式添加：windows 重装并勾选、macos 运行 shell command 命令、linux 用包管理器安装；切勿手动修改 shell 配置文件；powershell 需设 set-executionpolicy remotesigned -scope currentuser；验证需新开终端，检查 which/where code 路径及 code --status 进程 id 是否一致。
VS Code 启动时提示 code 命令未找到
这是最典型的症状：你在终端里敲 code .，系统直接报错 command not found: code。根本原因不是 VS Code 没装好，而是安装时没勾选「Add to PATH」选项，或者你用的是 Linux/macOS 的 tarball 版、Windows 的 zip 解压版——它们默认不改 PATH。
实操建议：
- Windows 用户：重新运行 VS Code 安装包（
VSCodeUserSetup-x64.exe），在最后一步勾选Add to PATH（哪怕已安装过，也能修复） - macOS 用户：打开 VS Code，按
Cmd+Shift+P输入Shell Command: Install 'code' command in PATH并回车执行 - Linux（deb/rpm 包安装）：通常自动注册；若没生效，检查是否执行过
sudo apt install code（Debian/Ubuntu）或sudo dnf install code（Fedora），而非手动解压
手动把 VS Code 加进 PATH 会出什么问题
有人会去改 ~/.bashrc 或 /etc/environment，硬加一条 export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH" —— 这样做短期能用，但极容易翻车。
常见错误现象：
- 终端重启后
code又失效（因为 shell 配置没重载，或用了 zsh 却只改了 bashrc） - 升级 VS Code 后路径失效（macOS 的 app bundle 内部路径可能变，
Resources/app/bin/code在新版本里已被移除） - 多用户环境里权限混乱（比如用
sudo改系统级 PATH，导致普通用户无法调用）
真正可靠的路径是 macOS 的 /usr/local/bin/code（由官方命令自动创建）、Windows 的 C:\Users\<user>\AppData\Local\Programs\Microsoft VS Code\bin\</user>（由安装器注册）、Linux 的 /usr/bin/code（包管理器维护）。别自己硬写。
Windows 下用 PowerShell 运行 code 报错“无法加载文件”
这是 PowerShell 默认执行策略限制，不是 PATH 问题。错误信息通常是：File xxx\code.ps1 cannot be loaded because running scripts is disabled on this system.
解决方法只有这一种有效路径：
- 以管理员身份打开 PowerShell
- 执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 之后再运行
code .就能正常启动
别用 Bypass 或改系统级策略，风险高；也别试图双击 code.ps1 手动执行——它只是个包装器，真身是 Code.exe。
确认 code 是否真的可用，别只看是否“不报错”
很多人输完 code --version 看到输出就以为搞定了，其实还有隐藏坑：比如 Windows 上 PATH 里混进了旧版本的 code.cmd，或者 macOS 上 which code 返回的是 Homebrew 装的旧版，和 GUI 启动的不是同一个二进制。
验证步骤要闭环：
- 新开一个终端窗口（别复用之前试过的）
- 运行：
which code（macOS/Linux）或where code（Windows CMD） - 对比输出路径是否和 VS Code 安装目录一致（如 macOS 应为
/usr/local/bin/code，且该文件是符号链接指向/Applications/Visual Studio Code.app/Contents/Resources/app/out/cli.js） - 再试
code --status，看输出里的processId和 GUI 窗口右下角显示的进程 ID 是否一致
路径对、进程对，才算真正接上了。中间任何一环断掉，编辑器和终端就是“看似能用，实则两套系统”。
