Windows系统全局安装Vercel CLI后执行vercel命令提示未识别问题

问题原因 #

该报错是由于你所用包管理器的全局包安装路径未添加到系统环境变量Path中，导致终端无法定位到vercel的可执行文件。

解决方案 #

步骤1：获取全局包安装路径 #

根据你安装Vercel时使用的包管理器，执行对应命令拿到全局安装目录：

• 使用npm安装：执行npm config get prefix，输出路径示例：C:\Users\你的用户名\AppData\Roaming\npm
• 使用yarn安装：执行yarn global bin
• 使用pnpm安装：执行pnpm bin --global

进入上述输出的路径，确认路径下存在vercel.cmd、vercel.ps1类可执行文件，若不存在可重新执行全局安装命令：npm install -g vercel（替换为对应包管理器的全局安装命令即可）。

步骤2：添加路径到系统环境变量 #

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在用户变量或系统变量列表中找到Path，双击进入编辑页
3. 点击「新建」，将步骤1拿到的全局包路径粘贴进去，依次点击所有弹窗的「确定」保存配置
4. 关闭所有已打开的终端/PowerShell窗口，重新打开后执行vercel --version验证是否生效

临时替代方案 #

如果不想修改环境变量，每次执行vercel命令前加上npx前缀即可，例如：
npx vercel login

特殊情况处理 #

如果添加环境变量后仍报错提示无法加载文件，是PowerShell执行策略限制导致，以管理员身份打开PowerShell，执行Set-ExecutionPolicy RemoteSigned，输入Y确认修改即可。

内容的提问来源于stack exchange，提问作者user8265953