当我们执行 npm run serve 时到底发生了什么?

在前端开发中, npm run serve 是一个常见的命令,尤其是在使用Vue CLI构建项目时。但是为什么直接运行 vue-cli-service serve 会报错,但使用 npm run serve 却可以成功启动项目呢?

npm scripts 的基本原理

先回顾一下 npm 命令的基本原理。在package.json文件中的 "scripts"字段允许我们定义一组自定义的命令。例如:

js 复制代码
"scripts": {
  "start": "node index.js",
  "serve": "vue-cli-service serve",
  // 其他命令...
}

这里 "serve"就是我们需要执行的命令,其对应的值是执行 vue-cli-service serve。运行 npm run serve 实际上是在执行 vue-cli-service serve命令。

为什么直接运行 vue-cli-service serve 会报错?

直接运行 vue-cli-service serve 会导致错误的主要原因在于 vue-cli-service 不是一个全局可执行命令,而是作为项目依赖安装在项目的 node_modules中。

运行 vue-cli-service serve 时,操作系统并不知道去哪里找这个命令。而通过 npm eun serve,我们在package.json的 "scripts"中定义了serve对应的命令是 vue-cli-service serve,这时 npm 根据查找规则就能够正确找到并执行这个命令。

npm run serve 查找规则

npm run serve 的执行过程涉及以下步骤:

  • 查找命令: npm 首先在当前项目目录的 node_modules/.bin 目录下查找是否存在 vue-cli-service 可执行文件。
  • 查找全局安装: 如果在项目的 node_modules/.bin 中没有找到 vue-cli-service, npm会继续在全局 node_modules/.bin 目录下查找< script>对应的可执行文件。
  • 执行命令: 找到 vue-cli-service 后,npm将执行该命令。

这个查找过程确保了我们可以在项目内部或全局的依赖中找到并执行指定的命令,相当于执行了 ./node_modules/.bin/vue-cli-service serve

npm scripts 的命令注入机制

在执行 npm run serve 时,npm实际上会将项目的 node_modules/.bin 目录添加到系统的PATH中。这个目录包含了大部分通过 npm install 安装的可执行文件,其中也包括了 vue-cli-service。

这样一来,系统就能够在全局范围内找到 vue-cli-service 命令,不用在命令行中指定完整的路径。

全局安装

当某个包被全局安装时,其可执行文件也会被放置在全局 node_modules/.bin目录中。如果全局的 node_modules/.bin目录也被加入系统的PATH中,那么在全局范围内就可以执行该可执行文件。

这种机制使得一些工具和命令行程序能够在任何地方都能被直接调用,而无需指定完整路径。

vue-cli-service 来自哪里

vue-cli-service 命令是 Vue CLI提供的可执行文件,在项目初始化会自动创建一个 .bin目录,其中包含了一些项目本地的可执行文件。

当我们通过Vue CLI创建一个新的Vue.js项目时,它会在项目的 node_modules/.bin 目录下创建一个名为 vue-cli-service(或者是vue-cli-service.cmd,这取决于你使用的是Windows还是其他系统)的可执行文件。

这个可执行文件实际上是指向项目安装的 @vue/cli-service 包中的bin/vue-cli-service.js 文件的一个软链接,这个文件是Vue CLI提供的命令行工具的入口文件。

当我们在package.json文件的"scripts"字段中使用vue-cli-service命令时,实际上是在调用这个项目本地的可执行文件,而不是全局安装的 Vue CLI。

好处在于每个Vue.js项目都可以有自己的vue-cli-service可执行文件,这样可以确保在不同的项目中使用不同版本的Vue CLI而不会相互影响。

npm scripts进阶用法

除了简单的命令,npm scripts 还支持并行执行多个命令,以及通过插件实现更高级的功能。以下是一个使用 npm-run-all 插件实现并行执行命令的例子:

js 复制代码
"scripts": {
  "start": "npm-run-all --parallel task1 task2",
  "task1": "command1",
  "task2": "command2"
}

在这个例子中, npm run start 将同时执行 task1和task2。

相关推荐
子非鱼a5 小时前
【WEB】[NewStarCTF 公开赛赛道]UnserializeOne
前端·javascript·html
南雨北斗5 小时前
Vue3 v-model中的自动事件绑定
前端
雪芽蓝域zzs6 小时前
第八节:Element Plus 基础、封装通用组件 + 路由守卫
前端·vue.js
码视野6 小时前
基于 Spring Boot + Vue3 的【智慧公厕微负压排风除臭与客流人感空间占用导引中台】设计与实现(含PRD/三端高保真源码/大屏)
前端·vue.js·人工智能·spring boot·后端
计算机魔术师7 小时前
刚赔了15亿又来被告?索尼华纳联手把Anthropic告上法庭
前端
笑霸final7 小时前
不用上传服务器!用 Vue3 + ONNX Runtime Web 在浏览器本地实现智能抠图
运维·前端·图像处理·ai·onnx·canva可画·web性能优化
月月大王的3D日记7 小时前
Three.js 入门系列(9):从零搭一座“闹鬼小屋”
前端·javascript
TingTing7 小时前
Vue3动态组件库建设
前端
码上暴富8 小时前
Cursor / VS Code 自定义文件颜色
前端·vscode
开开心心就好8 小时前
电子教鞭工具支持画框写字插图片功能齐全
android·开发语言·前端·javascript·人工智能·pdf·html