如何根据环境为npm配置自定义preinstall脚本？

一、跨环境preinstall脚本适配（Windows本地/服务器） #

你之前的Gradle方案无效，大概率是因为npmInstall任务本身会触发npm自带的preinstall钩子，导致自定义的forceResolutions任务执行后，npm install又重复执行了默认的preinstall脚本，或者devEnv参数未正确传递到Gradle中。这里给两个更可靠的方案：

方案1：用Node.js脚本自动判断环境 #

写一个跨平台的preinstall脚本，自动识别操作系统，执行对应命令：

1. 在项目根目录创建preinstall.js文件：

const { execSync } = require('child_process');

// 判断是否为Windows环境
const isLocalWindows = process.platform === 'win32';

const command = isLocalWindows
  ? 'npx npm-force-resolutions'
  : 'no_proxy=my.proxy.com npx npm-force-resolutions';

// 同步执行命令，输出与终端一致
execSync(command, { stdio: 'inherit' });

2. 修改package.json的scripts：

"scripts": {
  "preinstall": "node preinstall.js",
  // 其他脚本...
}

这样不管是本地Windows还是服务器环境，执行npm install时都会自动匹配对应命令，无需手动修改。

方案2：通过Gradle正确控制npm脚本执行 #

如果一定要用Gradle方案，需要确保参数传递正确并禁用npm自带的preinstall钩子：

修改Gradle任务：

task forceResolutions(type: NpmTask) {
    args = ['run', project.hasProperty('devEnv') && devEnv == 'true' ? 'preinstall-dev' : 'preinstall-ci']
}

npmInstall {
    // 禁用npm自带的preinstall钩子，避免重复执行
    args = ['install', '--ignore-scripts']
}

npmInstall.dependsOn forceResolutions

同时保留package.json中的两个脚本：

"scripts": {
  "preinstall-dev": "npx npm-force-resolutions",
  "preinstall-ci": "no_proxy=my.proxy.com npx npm-force-resolutions",
  // 其他脚本...
}

执行时通过./gradlew npmInstall -PdevEnv=true传递本地环境参数，Gradle会先执行自定义的resolution脚本，再执行忽略钩子的npm install，避免冲突。

二、primordials未定义报错解决 #

这个错误是Node.js 12与高版本graceful-fs不兼容导致的，按以下步骤修复：

1. 在package.json中添加resolutions字段，强制指定兼容版本：

"resolutions": {
  "graceful-fs": "^4.2.10"
}

（4.2.10是经过验证的Node.js 12兼容版本，不要使用5.x版本）

2. 确保preinstall脚本正常执行（参考上面的跨环境方案），npm-force-resolutions会在npm install前替换依赖版本，解决primordials未定义问题。

如果仍报错，手动删除node_modules和package-lock.json后重新执行安装命令，确保依赖被正确替换。

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