语义化版本号结合分支策略可解决测试镜像混用、追溯难、回滚难问题：通过feat-/dev-/release/分支定义标签前缀、Dockerfile注入Git上下文、K8s按标签隔离环境、自动清理与手动保留机制，实现镜像身份可识别、部署可隔离、生命周期可管控。
在多分支并存的开发架构下，测试镜像容易混用、难以追溯、回滚困难。语义化版本号（SemVer）本身不直接解决分支问题，但结合分支策略和标签生成规则，就能让每个测试镜像自带“身份信息”——既标明功能归属，又体现变更性质，还能与代码精确对应。
按分支类型定义语义化标签前缀
不同分支承载不同职责，标签应反映其定位：
-
feature/* 分支：用
feat-{功能名}-{短哈希}或v0.0.0-feat-login-abc123，强调临时性与可丢弃性，不参与 SemVer 主版本递增 -
develop 分支：每日构建可用
dev-$(date +%Y%m%d)-${COMMIT:0:7}，例如dev-20260617-4a8f2b1，便于测试团队按日期拉取最新集成版 -
release/* 分支：直接映射预发布版本，如
release/v1.5.0-rc.1，其中rc表示 release candidate，符合 SemVer 预发布标识规范
在 Dockerfile 中注入分支与版本上下文
构建时把 Git 分支名、当前 commit、是否干净工作区等信息写入镜像元数据，供运行时或健康检查读取：
- 在
Dockerfile中使用ARG接收 CI 传入参数：ARG GIT_BRANCH、ARG GIT_COMMIT、ARG BUILD_VERSION - 通过
ENV暴露为环境变量：ENV APP_BRANCH=$GIT_BRANCH APP_COMMIT=$GIT_COMMIT APP_VERSION=$BUILD_VERSION - 启动脚本或探针可打印这些值，测试人员一眼识别镜像来源
测试环境按标签做自动路由与隔离
避免多个 feature 镜像互相污染，需借助标签实现轻量级环境绑定：
- Kubernetes 中用
imagePullPolicy: IfNotPresent+ 明确指定image: myapp:feat-payment-9f3a1c2，确保每次部署都拉取对应分支镜像 - CI 流水线中，为每个 feature PR 自动创建独立命名空间（如
ns-feat-payment），并只允许该命名空间拉取带feat-payment-前缀的镜像 - 配合镜像仓库权限策略（如 Harbor 的项目级别 tag 策略），禁止
feat-*标签被推送到生产项目
保留可回溯的测试镜像生命周期
测试镜像不是一次性的，但也不能无限堆积：
- 所有
feat-*和dev-*镜像默认保留 14 天，过期自动清理；可通过git tag手动打keep/feat-login-v1临时延长保留期 - 每个
rc版本镜像必须附带完整的测试报告摘要（作为镜像label存储），例如：label=io.test.report-url=https://ci.example.com/job/rc-1.5.0/123/report - 当
rc-1.5.0升级为正式v1.5.0后，自动将v1.5.0镜像同步标记为stable和latest（仅限测试集群）
