关于npm的钩子函数

一、npm scripts 的生命周期钩子(Lifecycle Scripts)

npm 提供了一些 ​​特殊的 script 名称​​,它们是 ​​生命周期钩子​​,会在特定时机 ​​自动执行​​。这些钩子包括:

1.prepublishOnly(在 npm publish之前执行(仅发布前))

2.prepublish((已废弃,不推荐使用)在打包或发布前执行)

3.prepare(在 npm publish或 npm install(本地安装)时执行,包括 git clone后的安装)

4.preinstall(在安装依赖之前执行)

5.install(安装依赖时执行)

6.postinstall(在安装依赖之后执行(最常用的钩子之一))

7.preuninstall(在卸载包之前执行)

8.uninstall(在卸载包时执行)

9.postuninstall(在卸载包之后执行)

10.preversion(在修改版本号之前执行(比如 npm version patch))

11.version(修改版本号时执行)

12,postversion(修改版本号之后执行)

13.pretest(在运行 npm test之前执行)

14.test(运行测试)

15.posttest(在运行 npm test之后执行)

16.prestop(在运行 npm stop之前执行)

17.stop(停止服务)

18.poststop(在运行 npm stop之后执行)

19.prestart(在运行 npm start之前执行)

20.start(启动服务)

21.poststart(在运行 npm start之后执行)

22.prerestart(在运行 npm restart之前执行)

23.restart(重启服务)

24.postrestart(在运行 npm restart之后执行)

二、与 npm run build相关的钩子

虽然 build本身不是 npm 的生命周期钩子,但如果你在 package.json的 scripts中按如下方式定义了多个脚本:

javascript 复制代码
{
  "scripts": {
    "prebuild": "echo '即将开始构建...'",
    "build": "webpack --mode production",
    "postbuild": "echo '构建完成!'"
  }
}

那么当你运行: npm run build

在 npm 中,当你运行 npm run build命令时,npm 会根据你项目中的 package.json文件里 scripts字段下定义的 build脚本来执行相应的命令。但除了你显式定义的 build脚本本身,npm 还会在脚本执行 ​​前后​​ 自动触发一些 ​​生命周期钩子(Lifecycle Hooks)​​,这些钩子是 npm 内置的机制,在特定阶段自动运行。

不过,​​npm 默认并不会在运行 npm run build时自动执行额外的钩子,除非你显式地在 package.json的 scripts中定义了它们,或者它们是 npm 生命周期脚本中与 build相关联的钩子。​​

一、npm scripts 的生命周期钩子(Lifecycle Scripts)

npm 提供了一些 ​​特殊的 script 名称​​,它们是 ​​生命周期钩子​​,会在特定时机 ​​自动执行​​。这些钩子包括:

钩子名称

触发时机

prepublishOnly

在 npm publish之前执行(仅发布前)

prepublish

(已废弃,不推荐使用)在打包或发布前执行

prepare

在 npm publish或 npm install(本地安装)时执行,包括 git clone后的安装

preinstall

在安装依赖之前执行

install

安装依赖时执行

postinstall

在安装依赖之后执行(最常用的钩子之一)

preuninstall

在卸载包之前执行

uninstall

在卸载包时执行

postuninstall

在卸载包之后执行

preversion

在修改版本号之前执行(比如 npm version patch)

version

修改版本号时执行

postversion

修改版本号之后执行

pretest

在运行 npm test之前执行

test

运行测试

posttest

在运行 npm test之后执行

prestop

在运行 npm stop之前执行

stop

停止服务

poststop

在运行 npm stop之后执行

prestart

在运行 npm start之前执行

start

启动服务

poststart

在运行 npm start之后执行

prerestart

在运行 npm restart之前执行

restart

重启服务

postrestart

在运行 npm restart之后执行

⚠️ 注意:​​build不是 npm 的内置生命周期钩子​​,它只是一个普通的自定义脚本名称,除非你自己定义了它。

二、与 npm run build相关的钩子

虽然 build本身不是 npm 的生命周期钩子,但如果你在 package.json的 scripts中按如下方式定义了多个脚本:

{

"scripts": {

"prebuild": "echo '即将开始构建...'",

"build": "webpack --mode production",

"postbuild": "echo '构建完成!'"

}

}

那么当你运行:npm run build

npm 会 ​​自动按顺序执行以下脚本​​:

1.​​prebuild​​(如果定义了)→ 在运行 build之前执行

2.​​build​​ → 你显式运行的主要构建脚本

3.postbuild​​(如果定义了)→ 在运行 build之后执行

三、额外说明

•​​pre和 post钩子不仅适用于 build,也适用于其他自定义脚本​​,比如 prestart/ start/ poststart,或者 pretest/ test/ posttest等。

•​​这些钩子是 npm 的内置功能,不需要安装任何插件​​。

相关推荐
代码小学僧3 小时前
🎉 在 Tailwind 中愉快的使用 Antd Design 色彩
前端·css·react.js
ssshooter3 小时前
复习 CSS Flex 和 Grid 布局
前端·css·html
_请输入用户名4 小时前
EventEmitter 是广播,Tapable 是流水线:聊聊它们的本质区别
前端·设计模式
爱学习的茄子4 小时前
React Fiber:让大型应用告别卡顿的性能革命
前端·react.js·面试
龙在天4 小时前
我是前端,我来总结一下前端 配 Nginx 的一些案例
前端
Thetimezipsby4 小时前
基于Taro4打造的一款最新版微信小程序、H5的多端开发简单模板
前端·javascript·微信小程序·typescript·html5·taro
掘金安东尼4 小时前
前端周刊430期(2025年9月1日–9月7日)
前端
BUG创建者4 小时前
uni 拍照上传拍视频上传以及相册
前端·javascript·音视频
就是帅我不改4 小时前
敏感词过滤黑科技!SpringBoot+Vue3+TS强强联手,打造无懈可击的内容安全防线
前端·vue.js·后端