报错信息:
> ruoyi@3.8.8 dev
> vue-cli-service serve
'vue-cli-service' 不是内部或外部命令,也不是可运行的程序或批处理文件。
报错界面:

在启动若依 Vue 前端时执行npm run dev,报出vue-cli-service 不是内部或外部命令的错误,核心原因是项目的依赖包没有安装 / 安装不完整 ,导致找不到vue-cli-service这个核心执行命令,下面是解决方法:
第一步:先执行依赖安装(最核心、90% 的情况能解决)
这个错误的首要解决方式就是安装项目所有依赖,若依前端基于 Vue CLI 构建,必须先装包才能识别vue-cli-service。
1、确保终端进入了若依前端的根目录 (目录里能看到package.json、node_modules(可能为空 / 缺失)、vue.config.js这些文件,若依前端默认目录一般是ruoyi-ui);
2、执行安装命令:
npm install
若npm安装慢/失败,可换淘宝源安装(推荐)
npm install --registry=https://registry.npmmirror.com
3.安装完成后,再重新执行启动命令:
npm run dev

已经可以打包了
第二步:若第一步安装后仍报错,处理依赖安装异常情况
如果执行npm install后还是报同样的错,大概率是依赖安装中断、缓存问题或node_modules损坏,按以下步骤操作:
1. 删除旧的依赖和缓存,重新安装
1. 删除项目中的node_modules文件夹和package-lock.json锁文件
Windows系统
rd /s /q node_modules
del package-lock.json
2. 清除npm本地缓存(避免缓存导致的安装问题)
npm cache clean --force
3. 重新安装依赖(换源更稳定)
npm install --registry=https://registry.npmmirror.com
2. 检查 Node.js 和 npm 版本(若依有版本要求)
若依 Vue 前端对 Node.js 有版本限制,推荐 Node.js 14.x/16.x/18.x(过高的版本如 20 + 可能和旧版 Vue CLI 不兼容),检查方法:
查看node版本
node -v
查看npm版本
npm -v
如果版本过高 / 过低,建议安装nvm(Node 版本管理器),快速切换兼容的 Node 版本,切换后重新执行第一步的依赖安装。
第三步:极端情况(全局安装 Vue CLI 兜底)
如果上述步骤都试过仍报错,可全局安装 Vue CLI(若依前端的vue-cli-service也会关联全局命令),执行:
全局安装@vue/cli(和若依适配的版本)
npm install -g @vue/cli@4
安装完成后,重新在项目目录执行
npm run dev