语义化标签是docker镜像版本管理的基石，采用semver 2.0格式（如v2.1.4），其中major表示不兼容变更，minor表示兼容新功能，patch表示仅修复；生产环境必须禁用latest标签，应使用明确版本号（如v1.3.0）并可叠加环境标识（如v1.3.0-prod）或构建元数据（如v1.3.0-git-7f3a1b2）实现精准追踪与回溯。
语义化标签是 Docker 镜像版本管理的基石，它让镜像发布不再依赖模糊的 latest 或临时哈希，而是具备明确含义、可预测行为和可回溯依据。关键在于把版本号本身变成一种沟通语言——告诉团队这个镜像带来了什么变化。
语义化标签格式与核心规则
采用标准 SemVer 2.0 格式：MAJOR.MINOR.PATCH，例如 v2.1.4。
- MAJOR（主版本）：发生不兼容的 API 变更、底层架构重构或重大行为调整时递增（如 v1 → v2）
- MINOR（次版本）：新增向后兼容的功能，比如加了新接口、支持新配置项
- PATCH（修订版）：仅修复 bug、安全补丁或文档更新，不引入新功能
生产环境必须禁用 latest 标签
latest 不是版本，是“漂移标签”，无法保证一致性，CI/CD 流水线中使用会导致部署结果不可复现。
- 生产镜像推送命令应明确指定语义化版本：docker tag myapp:build-abc123 registry.example.com/prod/myapp:v1.3.0
- 若需稳定别名，可额外打一个固定标签（如 stable），但该标签需由人工或自动化流程显式更新，而非自动覆盖
多环境 + 多维度标签协同使用
单一语义化版本不够？那就叠加环境标识或构建元数据，形成组合标签，不破坏 SemVer 主干：
- v1.3.0-prod：生产环境专用版本
- v1.3.0-test：对应测试环境验证通过的同一构建产物
- v1.3.0-git-7f3a1b2：绑定具体 Git 提交，确保镜像与源码严格一致
- v1.3.0-build-20260721-1422：嵌入构建时间戳，便于排查问题时段
自动化打标与推送建议
避免手动输入标签引发错误，建议在 CI 流程中集成自动打标逻辑：
- 从 Git 标签自动提取版本号（如 git tag v1.3.0 触发构建）
- 使用 git describe --tags 生成带提交偏移的版本（如 v1.3.0-2-g7f3a1b2）
- 构建成功后，自动执行 docker tag 和 docker push，一次推送多个相关标签
- 在镜像仓库界面或 CLI 中，可通过标签前缀快速筛选（如查所有 v1.3.* 或 *-prod）
