解决报错：‘vite‘ 不是内部或外部命令，也不是可运行的程序或批处理文件

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

问题背景

当你在命令行运行 vite 命令时出现 'vite' 不是内部或外部命令，也不是可运行的程序或批处理文件。 错误时，说明系统找不到 vite 可执行文件。这通常是因为你没有正确安装 Vite，或者你的环境变量 PATH 没有包含 Vite 的安装路径。

解决方案

以下是几种可能的解决方案：

1. 全局安装 Vite

最常见的原因是你没有全局安装 Vite。你可以通过以下命令在全局范围内安装 Vite：

npm install -g vite

或者：

yarn global add vite

2. 确认安装完成

安装完成后，可以通过以下命令验证 Vite 是否已成功安装并可用：

vite --version

3. 确保环境变量包含 NPM 的全局安装路径

在某些情况下，NPM 的全局包安装路径可能没有添加到系统环境变量 PATH 中。你需要确保它们已正确添加：

对于 Windows 用户：

1. 打开命令提示符并运行以下命令来查找 NPM 全局包的安装路径：

   npm list -g
   

   通常，它的路径类似于：C:\Users\<你的用户名>\AppData\Roaming\npm

2. 将上述路径添加到系统环境变量：

   • 右键点击 “计算机” 或 “此电脑”
   • 选择 “属性”
   • 点击 “高级系统设置”
   • 点击 “环境变量”
   • 在 “系统变量” 部分，找到并选择 “Path”，然后点击 “编辑”
   • 点击 “新建” 并添加 NPM 全局包的路径，点击 “确定”

对于 macOS 和 Linux 用户：

1. 打开终端并运行以下命令来查找 NPM 全局包的安装路径：

   npm list -g
   

   通常，它的路径类似于：/usr/local/lib/node_modules/npm/bin/npm-cli.js

2. 编辑你的 shell 配置文件（如 .bashrc、.bash_profile 或 .zshrc）：

   nano ~/.bashrc  # 或 nano ~/.bash_profile, nano ~/.zshrc
   

3. 在文件末尾添加如下内容：

   export PATH=$PATH:/usr/local/bin:$(npm bin -g)
   

4. 保存文件并运行以下命令使配置生效：

   source ~/.bashrc  # 或 source ~/.bash_profile, source ~/.zshrc
   

4. 在项目级别安装 Vite

如果你不想全局安装 Vite，可以在项目中本地安装它，并通过 npx 或 yarn 来运行 Vite 命令：

npm install vite --save-dev

或者：

yarn add vite --dev

然后，通过 npx 或 yarn vite 来运行 Vite：

npx vite

或者：

yarn vite

示例与应用

以下是在终端中运行 Vite 相关命令的示例：

全局安装 Vite 并运行：

npm install -g vite
vite --version

在项目中安装 Vite 并运行：

mkdir my-vite-project
cd my-vite-project
npm init -y
npm install vite --save-dev
npx vite

总结

‘vite’ 不是内部或外部命令的错误通常是由于未正确安装 Vite，或系统路径变量中缺少 Vite 的安装路径。通过全局安装 Vite，确保环境变量中包含正确的路径，或者在项目级别安装 Vite 并使用 npx 或 yarn 来运行命令，可以解决这个问题。

希望本文对你理解和解决该错误有所帮助。如果你有任何问题或建议，欢迎在评论区留言讨论！