如何在package.json的dependencies中使用变量统一依赖版本号？

你提到的这种在dependencies里直接使用${npm_package_config_ver}变量的用法本身不被npm/yarn支持——只有scripts字段里的变量会被包管理器解析替换，dependencies是纯JSON字段，包管理器会把${npm_package_config_ver}当成字面量版本号去仓库查找，自然找不到匹配的包。

下面是几种可行的统一管理依赖版本的方案：

方案1：使用包管理器的版本强制功能 #

npm（8.3+）用overrides #

{
  "name": "my-app",
  "overrides": {
    "dep/a": "2.61.0",
    "dep/b": "2.61.0"
  },
  "dependencies": {
    "dep/a": "*",
    "dep/b": "*"
  }
}

overrides会强制指定依赖安装设定的版本，后续只要修改overrides里的版本号，重新执行install就能同步所有对应依赖的版本。

Yarn用resolutions #

{
  "name": "my-app",
  "resolutions": {
    "dep/a": "2.61.0",
    "dep/b": "2.61.0"
  },
  "dependencies": {
    "dep/a": "*",
    "dep/b": "*"
  }
}

逻辑和npm的overrides一致，Yarn会优先使用resolutions里指定的版本。

方案2：用模板+环境变量生成package.json #

1. 先创建一个package.json.template文件，用占位符标记版本：

{
  "name": "my-app",
  "dependencies": {
    "dep/a": "$VER",
    "dep/b": "$VER"
  }
}

2. 在实际的package.json里添加预安装脚本：

{
  "name": "my-app",
  "scripts": {
    "preinstall": "envsubst < package.json.template > package.json"
  }
}

3. 执行安装前先设置环境变量：

export VER=2.61.0 && yarn install

也可以把版本号写在.npmrc/.yarnrc里，避免每次手动输入。

方案3：Monorepo场景用 workspace 统一版本 #

如果是多包项目，可以在根目录的package.json里定义版本，子项目通过workspace:*引用：

// 根目录package.json
{
  "name": "my-monorepo",
  "workspaces": ["packages/*"],
  "dependencies": {
    "dep/a": "2.61.0",
    "dep/b": "2.61.0"
  }
}

// 子项目package.json
{
  "name": "my-app",
  "dependencies": {
    "dep/a": "workspace:*",
    "dep/b": "workspace:*"
  }
}

这种方式适合多包协作的项目，版本统一在根目录维护。

内容的提问来源于stack exchange，提问作者Peter Störmer