如何在Node.js微服务与Docker构建中实现版本DRY

这问题我之前在搭建基于Docker+Kubernetes的Node.js微服务集群时正好踩过坑，分享几个能完美实现你需求的方案，全程保持版本号只在package.json里维护，完全符合DRY原则：

方案1：直接用npm内置环境变量（最简便） #

npm在运行scripts里的命令时，会自动注入一系列环境变量，其中$npm_package_version就对应package.json里的version字段。直接在构建脚本里用它就行，连字符串处理都省了：

修改你的package.json：

{
  "name": "your-service",
  "version": "1.2.3",
  "scripts": {
    "docker:build": "docker build -t your-service:$npm_package_version ."
  }
}

运行的时候直接执行：

npm run docker:build

这样构建出来的镜像标签就是your-service:1.2.3，完全和package.json版本同步，而且版本号只在一个地方维护。

注意：如果是Windows环境，要把$npm_package_version换成%npm_package_version%，或者用cross-env包来做跨平台兼容。

方案2：结合Docker Build Args（更灵活） #

如果需要在Dockerfile里也用到版本号（比如打镜像标签、设置LABEL等），可以用Docker的构建参数来传递版本，同时还是从package.json取：

首先修改Dockerfile，加入构建参数：

# 接收外部传入的版本号
ARG SERVICE_VERSION
# 把版本号加入镜像元数据
LABEL service.version=$SERVICE_VERSION

# 其他构建步骤...
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
CMD ["npm", "start"]

然后在package.json的脚本里传递这个参数：

{
  "scripts": {
    "docker:build": "docker build --build-arg SERVICE_VERSION=$npm_package_version -t your-service:$npm_package_version ."
  }
}

这个方案不仅能给镜像打标签，还能让Dockerfile里也用上统一的版本号，适合需要在镜像内标记版本的场景。

方案3：用npm pkg命令提取版本（兼容旧版npm） #

如果你的npm版本比较旧（低于7.x），$npm_package_version可能有兼容性问题，那就用npm pkg get version命令来提取版本号，再去掉多余的引号：

{
  "scripts": {
    "docker:build": "docker build -t your-service:$(npm pkg get version | tr -d '\"') ."
  }
}

tr -d '\"'的作用是把npm输出的带双引号的版本号（比如"1.2.3"）转换成纯字符串1.2.3。

额外提示 #

• 如果是monorepo项目，要确保只取当前包的版本，可以在命令里加--workspaces=false参数：npm pkg get version --workspaces=false
• 后续部署到Kubernetes时，也可以用同样的方式把版本号注入到Deployment的镜像标签里，比如用CI/CD工具读取package.json的版本号来生成部署配置，全程保持版本统一。

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