根本原因是安装时未勾选“添加到PATH”选项，导致系统无法定位code命令；需通过命令面板执行“Shell Command: Install 'code' command in PATH”并以管理员权限运行VSCode完成修复。
VSCode 的 code 命令不是单独“安装”的，而是安装时勾选选项后自动生成的；没出现 code 命令，90% 是安装时漏勾了“添加到 PATH”。
为什么输入 code 提示“不是内部或外部命令”
这个错误根本不是命令没装，而是系统根本不知道 code 在哪。VSCode 安装程序本身会把 code 这个可执行文件（其实是 code.cmd）复制到一个路径下，并把这个路径加进系统的 PATH 环境变量——但前提是安装时你手动勾选了对应选项。
常见触发场景：
- 安装时跳过了“附加任务”页面，直接点下一步
- 勾选了“创建桌面快捷方式”，但没勾“添加到 PATH”
- 用了 System Installer 版本，却没以管理员身份运行安装程序（导致 PATH 写入失败）
补救：不重装也能让 code 命令生效
不用卸载重装，直接在 VSCode 里一行命令搞定：
打开 VSCode → 按 Ctrl+Shift+P 打开命令面板 → 输入 shell command → 选择 Shell Command: Install 'code' command in PATH
注意：
- 该操作需要 VSCode 有管理员权限（Windows 下首次运行可能弹 UAC 提示，点“是”）
- 执行完后必须关闭并重启所有已打开的终端（CMD/PowerShell/Git Bash），否则旧终端仍读不到新 PATH
- 如果提示“command not found”或报错，说明当前 VSCode 实例没有写入系统 PATH 的权限，此时才需要右键以管理员身份重新运行 VSCode 再试一次
code 命令常用用法和坑点
code 不只是打开编辑器，它支持多种上下文启动方式，但参数行为容易混淆：
-
code .：在当前目录打开 VSCode（推荐用于项目根目录） -
code filename.py：打开单个文件，如果 VSCode 已运行，会在已有窗口中新建标签页 -
code -r .：强制在当前窗口重用（-r=--reuse-window），避免误点多次弹出多个窗口 -
code --folder-uri file:///D%3A/project：Windows 路径含空格或特殊字符时，需 URL 编码，直接写D:\project会失败 - 在 WSL 中运行
code .会失败——这不是命令问题，而是 WSL 默认没装 VSCode Server，需先在 Windows 端打开过一次对应文件夹才会自动部署
验证 code 是否真可用，别只看 CMD 能敲出来
很多人在 CMD 里输 code --version 显示版本号就以为 OK 了，其实还不够。真正要验证的是：能否从任意路径、任意终端、打开任意本地项目目录。
建议三步实测：
- 打开一个新的 PowerShell 窗口（不复用旧的）→ 输入
code --version→ 确认输出正常 - 切到任意非 VSCode 安装路径的文件夹（比如
D:\temp）→ 输入code .→ 观察是否秒开新窗口且工作区正确加载 - 再开一个 CMD → 输入
code hello.js→ 看是否在已有窗口中新建标签页，而不是弹第二个 VSCode
这三步都通过，code 命令才算真正落地可用。很多所谓“已配置好”的环境，卡在第三步——本质还是 PATH 或复用逻辑没理清。
