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

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

npm scripts 的基本原理

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

"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 run 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-servicenpm 会继续在全局 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 插件实现并行执行命令的例子:

"scripts": {
  "start""npm-run-all --parallel task1 task2",
  "task1""command1",
  "task2""command2"
}

在这个例子中,npm run start 将同时执行 task1task2


- END -


360 W3C ECMA TC39 Leader 注和加


相关推荐

  • 也看Graph CoT–大模型与知识图谱结合工作:兼看多模态大模型进展综述
  • 智猩猩AI智能体技术研讨会最终议程公布!6位学者和开发大牛现场解读AI智能体内涵
  • 神级代码注释,喜欢的拿去用
  • AI大模型,这个就叫专业!
  • 一笔漂亮的退出:回报5个亿
  • 如何促进你的职业发展?个人专著《工作的心智》,今日开始预售
  • 腾讯云披露 4 月 8 日服务故障原因;北京技术人员月平均薪酬中位值超1.2万元 | 极客头条
  • 硅谷 CEO 立「千万赌约」,邀马斯克应战:“我用 1000 万美元,赌你的 AI 预测是错的!”
  • 做代码搜索真的太难了!
  • 四年磨一剑,腾讯云亮出业内首款全自研AIGC存储解决方案
  • 量子位下一个AI选题,你说了算
  • 北大字节开辟图像生成新范式!超越Sora核心组件DiT,不再预测下一个token
  • 融合ChatGPT+DALL·E 3,贾佳亚团队新作开源畅玩:识图推理生图一站解决
  • 人在B站,要被AI公司们挤爆了
  • 面试太紧张怎么破?
  • Slack 借助 Z 分数监控克服部署恐惧
  • 走进 Rust 世界:打破界限,成为硬核程序员 | 极客时间
  • Higress 全新 Wasm 运行时,性能大幅提升
  • 创始团队仅 3 人、估值最高 25 亿美元,万字长文讲述 RISC-V 商业帝国崛起背后的故事
  • 钉钉卡位战:SaaS 挣不到的钱,Agent 会挣到