Docker Compose 通过 Compose 文件版本、镜像标签和运行时环境变量三者协同实现应用版本号规范管理：version 字段标识配置语法版本；image 标签（如 v1.5.0）作为发布版本主标识；environment 或 build.args 注入 VERSION 变量供应用读取，并支持 .env 文件解耦配置。
Docker Compose 本身不直接管理应用逻辑版本号，但可以通过配置文件结构、构建上下文和环境变量协同实现清晰、可追溯、可复用的版本号规范管理。关键在于把“版本”这个概念落到三个可管控的位置：Compose 文件版本、镜像标签（image tag）、以及应用内实际使用的语义化版本（如 VERSION=1.2.3）。
明确区分三类版本号及其作用
混淆这三者是常见误区：
-
docker-compose.yml 的 version 字段：指 Compose 配置文件语法格式版本（如
version: '3.8'），决定支持哪些配置项（如secrets、deploy）。它与 Docker Engine 版本强相关，不是你应用的版本。 -
服务的 image 标签：如
image: myapp:v1.5.0或image: registry.example.com/myapp:20260813-rc1。这是最直观、最推荐绑定应用版本的方式，便于拉取、回滚、审计。 -
运行时注入的应用版本变量：通过
environment或build.args传入，让容器内程序能读取并显示自身版本（例如在 HTTP 响应头或健康检查接口中返回{"version": "1.5.0"}）。
用 build.args + ARG 在 Dockerfile 中固化构建版本
适用于从源码构建镜像的场景。在 Dockerfile 中声明参数，在 docker-compose.yml 中传入，确保每次构建都带明确版本标识：
— Dockerfile：
ARG VERSION=dev ENV VERSION=$VERSION # ... 其他指令
— docker-compose.yml：
services:
web:
build:
context: .
dockerfile: Dockerfile
args:
- VERSION=1.5.0
environment:
- VERSION=1.5.0
这样构建出的镜像不仅运行时有 VERSION 环境变量，镜像元数据里也隐含了该构建意图，配合 docker inspect 可查。
用 image 标签统一标识发布版本（推荐主用）
对已构建好的镜像，直接用带语义化标签的 image 字段，是最轻量、最可靠、CI/CD 最易集成的方式：
- 开发测试用
image: myapp:latest（仅限本地或临时环境） - 预发布用
image: myapp:staging-v1.5.0-20260813 - 正式发布严格使用不可变标签：
image: myapp:v1.5.0或image: myapp@sha256:abc123...
搭配 CI 流水线自动打标（如 Git Tag 触发构建并推送 vX.Y.Z 镜像），docker-compose.yml 文件本身只需改一行 image，即可完成版本切换与部署一致性保障。
通过 .env 文件解耦版本配置，提升复用性
避免在多个 compose 文件中硬编码版本号。创建 .env 文件统一管理：
APP_VERSION=v1.5.0 COMPOSE_PROJECT_NAME=myapp-prod
然后在 docker-compose.yml 中引用：
services:
web:
image: myapp:${APP_VERSION}
environment:
- APP_VERSION=${APP_VERSION}
不同环境（dev/staging/prod）可维护各自的 .env，执行时自动加载：docker compose --env-file .env.staging up。Git 提交 .env 模板（如 .env.example），忽略真实 .env，兼顾安全与协作。
