Node.js应用按部署环境安装不同版本依赖包的方案咨询

这问题我在项目里碰到过好几次，给你几个实用的解决办法，挑适合你部署流程的用就行：

1. 用npm脚本+环境变量直接指定版本 #

这是最直接的方式，不用额外写脚本，在package.json里定义两个安装脚本就行：

{
  "scripts": {
    "install:dev": "NODE_ENV=develop npm install bootstrap@^5.2.0 --save",
    "install:prod": "NODE_ENV=production npm install bootstrap@4.2.0 --save"
  }
}

使用方式： #

• 开发环境安装：npm run install:dev
• 生产环境安装：npm run install:prod

跨平台注意： #

如果你的团队有用Windows的成员，直接写NODE_ENV=develop会报错，建议装个cross-env包来统一环境变量设置：

npm install cross-env --save-dev

然后修改脚本：

{
  "scripts": {
    "install:dev": "cross-env NODE_ENV=develop npm install bootstrap@^5.2.0 --save",
    "install:prod": "cross-env NODE_ENV=production npm install bootstrap@4.2.0 --save"
  }
}

2. 写Node脚本自动修改package.json后安装 #

如果想让流程更自动化（比如部署脚本里一键搞定），可以写个简单的Node脚本自动处理版本切换：

创建一个install-deps.js文件：

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

// 获取环境变量，默认用develop
const env = process.env.NODE_ENV || 'develop';
// 读取package.json
const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));

// 根据环境设置bootstrap版本
if (env === 'develop') {
  packageJson.dependencies.bootstrap = '^5.2.0';
} else if (env === 'production') {
  packageJson.dependencies.bootstrap = '4.2.0';
}

// 写回package.json
fs.writeFileSync('./package.json', JSON.stringify(packageJson, null, 2));
// 执行npm install
execSync('npm install', { stdio: 'inherit' });

然后在package.json里加一个脚本：

{
  "scripts": {
    "install:deps": "node install-deps.js"
  }
}

使用方式： #

• 开发环境：npm run install:deps（或者显式指定：cross-env NODE_ENV=develop npm run install:deps）
• 生产环境：cross-env NODE_ENV=production npm run install:deps

这个方法的好处是不用每次手动记版本号，脚本会自动帮你更新package.json并安装依赖，适合自动化部署场景。

3. 在部署脚本里做条件判断 #

如果你的部署流程用的是Shell脚本（Linux/macOS）或者批处理（Windows），可以直接在部署脚本里加条件判断：

Linux/macOS Shell脚本示例： #

#!/bin/bash
if [ "$NODE_ENV" = "production" ]; then
  echo "安装生产环境依赖..."
  npm install bootstrap@4.2.0 --save
else
  echo "安装开发环境依赖..."
  npm install bootstrap@^5.2.0 --save
fi
# 安装其他依赖
npm install

Windows批处理示例： #

@echo off
IF "%NODE_ENV%"=="production" (
  echo 安装生产环境依赖...
  npm install bootstrap@4.2.0 --save
) ELSE (
  echo 安装开发环境依赖...
  npm install bootstrap@^5.2.0 --save
)
npm install

注意事项： #

不管用哪种方法，记得确保NODE_ENV环境变量在执行时是正确设置的。另外，如果你的项目里有锁定文件（package-lock.json或yarn.lock），每次切换环境后最好删掉锁定文件再重新安装，避免版本冲突。

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