必须将VSCode的bin目录路径添加到系统PATH环境变量才能通过命令行启动code命令；Windows需添加至系统变量Path，macOS/Linux还需赋予code文件执行权限。
必须把 code 命令加进系统 PATH，否则 VSCode 无法从任意目录通过命令行启动。 VSCode 安装包默认不修改系统环境变量，所以 code . 在 CMD/PowerShell 或终端里直接报“不是内部或外部命令”是常态，不是安装失败或配置错误。
找到 VSCode 的 bin 目录并确认 code 可执行文件存在
VSCode 的命令行工具 code 不在主程序目录下，而在其 bin 子目录中。Windows 上常见路径包括：
C:Users\AppDataLocalProgramsMicrosoft VS Codein-
D:installMicrosoft VS Codein（若自定义安装）
打开该目录，确认里面存在 code.cmd（Windows）或 code（macOS/Linux）。如果找不到，说明你安装的是「User Installer」版本且未勾选「Add to PATH」——此时建议卸载后重装，勾选该选项；或手动定位到正确路径。
把 bin 路径添加到系统 PATH 环境变量
这是唯一可靠、全局生效的方式。不要只加到用户变量（尤其 Windows GUI 启动的 VSCode 可能读不到），推荐加到「系统变量」的 Path 中：
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」列表中找到
Path，点击「编辑」→「新建」 - 粘贴你确认过的完整
bin路径，例如：C:UsersJohnAppDataLocalProgramsMicrosoft VS Codein - 点击「确定」逐级保存
⚠️ 注意：路径末尾不要加反斜杠 ，也不要包含 code.cmd 文件名本身，只填到 bin 目录层级。
验证是否生效及常见失效原因
新开一个 CMD 或 PowerShell（旧终端不会自动继承新 PATH），运行：
code --version
能输出版本号即成功。如果仍失败，检查以下几点：
- 是否重启了终端？PATH 修改后，已打开的终端进程不会刷新环境
- 是否误把路径加到了「用户变量」的
Path，而当前 VSCode 是通过开始菜单启动的 GUI 进程（它默认只读系统变量） - 路径中是否含中文、空格或特殊字符？虽然现代系统支持，但某些旧 shell 会出问题，建议路径尽量简洁纯英文
- 是否多个 VSCode 安装共存？比如同时有 User 和 System 版本，
PATH指向了已卸载的旧路径
macOS/Linux 用户还需确保 code 文件有可执行权限：chmod +x /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code（路径依实际安装位置调整）。
真正容易被忽略的是：VSCode 启动方式决定它能否读取你设的 PATH。哪怕 PATH 配对了，如果你用快捷方式双击启动 VSCode，它可能仍拿不到用户级变量；而用终端执行 code . 启动的实例，才能 100% 继承当前 shell 的全部环境。所以日常开发中，建议养成用终端启动 VSCode 的习惯。
