检查npm全局安装包版本为何必须使用npx？直接运行命令报错

调用npm生态下的工具命令时，直接输入命令名执行会提示不存在，必须加npx前缀才能正常运行。以Vue CLI版本检查为例，执行返回结果如下：

vue --version
bash: vue: command not found

npx vue --version
@vue/cli 5.0.6

• 未全局安装对应工具包：如果@vue/cli只装在某个本地项目的node_modules里，没有做全局安装，系统全局路径下自然找不到vue可执行文件；而npx运行时会自动检索当前目录下的项目依赖，所以能正常调用本地安装的版本。
• 全局包路径未加入系统环境变量：如果已经做过全局安装还是报错，是因为npm全局安装的可执行文件所在目录，没有被加入系统的PATH环境变量，终端遍历可执行路径时找不到对应命令；npx自带npm路径检索逻辑，不受这个配置影响。

1. 先执行全局安装命令，确保工具已经装到npm全局目录下：

   npm install -g @vue/cli
   

2. 如果安装完直接执行还是报命令不存在，先查询npm全局安装的根路径：

   npm config get prefix
   

3. 把上一步输出的路径下的bin目录，添加到系统PATH环境变量中：
   • Windows：打开系统环境变量设置面板，在用户变量/系统变量的Path条目里，追加[刚才查询到的prefix路径]\bin，保存后重启终端即可。
   • Mac/Linux：根据你使用的shell，编辑对应配置文件（bash对应~/.bashrc，zsh对应~/.zshrc），追加一行配置：

     export PATH="$(npm config get prefix)/bin:$PATH"
     

     保存后执行source 对应配置文件路径让配置立即生效。
4. 重启终端后直接执行vue --version验证，能正常输出版本号即修复完成。

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