npm 8.19（Node 18）无法运行自定义包的prepare/postinstall脚本

核心排查与修复步骤 #

• 检查npm脚本执行开关：执行npm config get ignore-scripts，如果输出是true，直接运行npm config set ignore-scripts false开启脚本执行权限。
• 确认包的私有状态：自定义包的package.json里如果private设为true，npm会跳过生命周期脚本，把它改成false再试。
• 验证脚本定义位置：确保postinstall/prepare脚本是写在自定义包的package.json的scripts字段下，而非依赖它的应用的配置里，示例格式：

  {
    "name": "your-custom-package",
    "scripts": {
      "postinstall": "your-actual-script-command",
      "prepare": "your-actual-script-command"
    }
  }
  

• 单独测试脚本可用性：直接在自定义包目录下运行脚本命令（比如your-actual-script-command），排查脚本本身的问题：
  • Node脚本要检查是否兼容Node 18，有没有用已废弃的API；
  • Angular相关命令要匹配Angular 15的CLI规则，比如旧版的ng build --prod要改成ng build --configuration production。
• 清理缓存重新安装：执行npm cache clean --force清空缓存，删除应用的node_modules和package-lock.json，再运行npm install，避免缓存干扰。
• 查看详细安装日志：用npm install --verbose执行安装，从完整日志里找“skipping script”类的提示，或是脚本执行时的错误细节（比如依赖缺失、权限问题），比--foreground-scripts能暴露更多信息。
• 排查系统权限（类Unix系统）：如果是Linux/macOS环境，给脚本文件加执行权限：chmod +x path/to/your-script-file；Node脚本开头要加上#!/usr/bin/env node声明。

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