组件库preinstall/postinstall脚本被项目安装时触发执行问题排查

问题现象 #

• 组件库的preinstall/postinstall脚本原本仅用于自身开发环境搭建（拉取Git子模块、配置npmrc等），但昨日之后发布的版本，在项目中执行npm i @mylib/component-library-react时会意外触发这些脚本，导致报错：

  npm error bash: scripts/pipelines/npmrc/prepare_npmrc.sh: No such file or directory
  

• 仅昨日后创建的版本标签受影响，多项目多机器均出现该问题；项目的package-lock.json中对应包条目新增了"hasInstallScript": true字段。

根因分析 #

1. npm默认会在包被安装到宿主项目时执行preinstall/postinstall脚本，除非发布的包中不存在这些脚本，或者脚本有条件判断跳过执行。
2. 之前的组件库构建发布流程应该会自动移除这些开发专属脚本，但昨日构建环节发生变更，导致这些脚本被保留在发布包的package.json中。
3. 发布包未包含scripts/目录（构建时通常只打包编译后的产物，不会携带开发脚本），因此脚本执行时找不到对应shell文件，触发127错误。
4. package-lock.json中的hasInstallScript: true是npm检测到包存在install类脚本后自动添加的标记，用于加速后续安装流程。

解决方案 #

临时应急方案 #

直接移除组件库package.json中的preinstall和postinstall脚本，重新发布版本。

永久根治方案 #

方案1：构建发布时自动剔除开发脚本

在组件库的发布流程中添加步骤，自动修改发布用的package.json，移除preinstall/postinstall字段。例如：

• 使用replace-in-file工具在打包后、发布前执行修改：

  npx replace-in-file '("preinstall"|"postinstall"):.*' '' ./dist/package.json
  

• 或者在rollup/webpack等打包工具的配置中，通过插件修改输出的package.json。

方案2：给脚本加条件判断，仅本地开发时执行

修改组件库package.json中的脚本，通过判断当前环境是否为组件库的开发环境（比如是否存在.git目录）来决定是否执行：

"postinstall": "if [ -d .git ]; then bash scripts/pipelines/npmrc/reset_npmrc.sh && husky install && npx browserslist@latest --update-db; fi",
"preinstall": "if [ -d .git ]; then npm run sub-module-update && bash scripts/pipelines/npmrc/prepare_npmrc.sh; fi"

这样脚本只会在组件库的本地Git仓库中执行，安装到项目的node_modules时会自动跳过。

方案3：项目侧临时规避（不推荐长期使用）

在安装组件库时添加--ignore-scripts参数，跳过所有依赖的脚本执行：

npm i @mylib/component-library-react --ignore-scripts

注意：此参数会跳过所有依赖的install脚本，可能影响其他包的正常初始化。

内容的提问来源于stack exchange，提问作者Snake_py