VSCode 的 code 命令需用户级安装并勾选「Add to PATH」才可免权限调用；否则出现 command not found 等问题，根源在于安装路径与系统 PATH 未正确匹配，Mac/Linux 还需手动配置 shell 环境变量。
VSCode 命令行调用 code 命令，不需要管理员权限，但前提是安装时勾选了「Add to PATH」且安装方式为用户级（User Installer）。 否则你会遇到 command not found、'code' is not recognized 或打开空白窗口等现象——这不是环境变量没生效，就是权限路径被系统拦截了。
Windows 上 code 命令失效的常见原因
根本问题不在 Node.js 或 Git，而在于安装路径和系统 PATH 的配合关系：
- 用了 System Installer（系统级安装）但没以管理员身份运行安装程序 →
code写入系统 PATH 失败 - 用了 User Installer 但没勾选「Add to PATH」→ PATH 里压根没加那条用户级路径
- 勾选了「Add to PATH」但没重启终端 → Windows 不会自动刷新当前 CMD/PowerShell 的环境变量
- 安装后手动改过 PATH，却漏掉了用户目录下的真实路径：
C:\Users\{用户名}\AppData\Local\Programs\Microsoft VS Code\bin
Mac/Linux 下 code 命令不可用怎么修？
Mac 和 Linux 默认不自动写 PATH，必须靠安装包或手动配置。重点看 bin 目录是否在 shell 配置文件中声明：
- macOS：检查
~/.zshrc或~/.bash_profile是否包含export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin" - Linux（deb/rpm 安装）：通常会自动注册
/usr/share/code/bin到 PATH；若用 tar.gz 手动解压，则需自己把./code/bin加入 PATH - 验证方式统一：终端执行
which code，有输出才说明 PATH 生效；没输出就别急着配插件，先修这步
为什么推荐用户安装（User Installer）而不是系统安装？
不是为了“更安全”，而是为了「可预测性」和「免干扰」：
- 用户安装路径固定、无需提权，PATH 注入由安装器自主完成，不会被组策略或杀软拦截
- 系统安装常被企业域策略禁止写入
Program Files，导致code命令注册失败且无提示 - 多账户共用一台机器时，系统安装可能让其他用户也能调用
code，但实际找不到你当前用户的扩展或设置（因为配置在用户目录） - 更新行为不同：用户安装支持后台静默更新；系统安装每次升级都弹 UAC，打断开发流
真正容易被忽略的一点是：code . 在子目录下启动 VSCode 时，它读取的是当前工作目录的 .vscode/settings.json，而不是全局设置。很多人配好了全局格式化工具，却在某个项目里发现 Prettier 不生效——其实是项目级配置覆盖了它，而这个覆盖行为，只有通过命令行打开项目才能复现出来。
