Angular项目中如何在npm install前校验Node/CLI版本并提示不匹配信息

这个需求很常见，尤其是在团队协作或者需要严格控制运行环境的项目中。下面是一套简单可靠的实现方案，能在用户执行npm install时自动校验Node和Angular CLI版本，不符合要求就终止安装并给出明确提示：

步骤1：创建版本校验脚本 #

在项目根目录新建一个check-versions.js文件，用Node.js编写版本逻辑。这个脚本不依赖任何第三方包，避免了依赖未安装导致的报错问题：

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

// 定义项目要求的基准版本（对应你的5.2.1）
const REQUIRED_NODE = { major: 5, minor: 2, patch: 1 };
const REQUIRED_ANGULAR_CLI = { major: 5, minor: 2, patch: 1 };

// 辅助函数：将版本字符串解析为便于比较的对象
function parseVersion(versionStr) {
  const parts = versionStr.replace('v', '').split('.').map(Number);
  return {
    major: parts[0],
    minor: parts[1],
    patch: parts[2] || 0
  };
}

// 辅助函数：校验当前版本是否符合要求（规则：主版本一致、次版本一致、补丁版本≥基准值）
function isVersionValid(current, required) {
  // 主版本必须完全匹配（比如5.x可以，6.x不行）
  if (current.major !== required.major) return false;
  // 次版本必须完全匹配（比如5.2.x可以，5.3.x不行）
  if (current.minor !== required.minor) return false;
  // 补丁版本允许等于或高于基准值（比如5.2.1、5.2.6都符合要求）
  return current.patch >= required.patch;
}

// 检查Node.js版本
const nodeVersionStr = process.version;
const nodeVersion = parseVersion(nodeVersionStr);
if (!isVersionValid(nodeVersion, REQUIRED_NODE)) {
  console.error(`❌ Node版本不符合要求！当前版本: ${nodeVersionStr}, 仅允许5.2.x版本（补丁版本≥1）`);
  process.exit(1); // 终止进程，npm会中断安装
}

// 检查Angular CLI版本
try {
  // 用--json参数输出结构化数据，方便解析
  const ngOutput = execSync('ng version --json', { encoding: 'utf8' });
  const cliInfo = JSON.parse(ngOutput);
  const cliVersionStr = cliInfo.cli.version;
  const cliVersion = parseVersion(cliVersionStr);
  
  if (!isVersionValid(cliVersion, REQUIRED_ANGULAR_CLI)) {
    console.error(`❌ Angular CLI版本不符合要求！当前版本: ${cliVersionStr}, 仅允许5.2.x版本（补丁版本≥1）`);
    process.exit(1);
  }
} catch (err) {
  console.error('❌ 无法检测Angular CLI版本，请确保Angular CLI已全局安装且`ng`命令可正常使用');
  process.exit(1);
}

// 校验通过，继续安装流程
console.log('✅ Node和Angular CLI版本校验通过，开始安装依赖...');

步骤2：配置npm生命周期脚本 #

打开项目的package.json，在scripts字段中添加preinstall脚本，指向我们刚才创建的校验文件：

{
  "scripts": {
    "preinstall": "node check-versions.js",
    "start": "ng serve",
    "build": "ng build",
    // 其他现有脚本...
  }
}

原理说明 #

npm的生命周期脚本中，preinstall会在npm install（包括npm ci）执行前自动运行。如果脚本返回非0的退出码（比如我们用process.exit(1)），npm会立即终止安装流程，并把脚本中的错误信息打印到控制台，用户就能清楚看到哪里不符合要求。

额外调整建议 #

• 如果需要修改版本允许范围，直接调整isVersionValid函数的逻辑即可，比如允许主版本相同的所有次版本，或者更复杂的规则。
• 如果希望优先检测项目本地安装的Angular CLI（而非全局），可以把ng version改成npx ng version，不过注意preinstall阶段本地依赖还未安装，npx会临时下载对应版本，可能会增加一点等待时间。

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