3. Feature Flag 核心概念：Flag 类型、生命周期与命名规范
Feature Flag（特性开关）是灰度发布与持续交付的核心技术组件。要构建一个稳定、可审计的发布工程自助门户，必须深入理解 Flag 的三种核心维度：类型（决定“如何生效”）、生命周期（决定“何时存在”）和命名规范（决定“如何管理”）。本章将逐一拆解这些基础概念，为后续的架构设计与平台实现奠定理论基石。
3.1 Flag 类型：Boolean / Percentage / Contextual
Feature Flag 按匹配逻辑可分为三大类。每种类型对应不同的发布场景与风险等级，自助门户必须同时支持这三种模式，才能覆盖从“全量上线”到“精细化灰度”的全部需求。
| 类型 | 匹配逻辑 | 典型场景 | 风险等级 |
|---|---|---|---|
| Boolean（布尔） | 全局 ON / OFF | 功能开关、紧急回滚、环境隔离 | 低（全量控制） |
| Percentage（百分比） | 按流量百分比随机分配 | 金丝雀发布、A/B 测试流量分配 | 中（渐进式） |
| Contextual（上下文） | 按用户属性/请求属性匹配 | 内测用户组、地域灰度、白名单 | 高（精准控制） |
实践建议：在自助门户中，Boolean 类型应作为“紧急开关”保留最高操作权限；Percentage 类型用于自动化金丝雀流程；Contextual 类型则开放给业务团队自行配置内测名单，实现“谁开发、谁灰度”。
下图展示了三种 Flag 类型在发布流程中的决策路径与流量分配逻辑：
3.2 Flag 生命周期
Feature Flag 并非永久存在的配置项。一个健康的发布工程体系必须管理 Flag 从“创建”到“清理”的完整生命周期。长期残留的过期 Flag 会导致代码混乱、维护成本激增，甚至引发配置冲突。
标准 Flag 生命周期包含以下五个阶段：
- 创建（Create）：开发者在自助门户中申请新 Flag，填写名称、类型、初始值、负责人及预期存活时间。
- 激活（Active）：Flag 处于生效状态，用于控制目标功能的发布范围。此阶段可动态调整值或规则。
- 稳定（Stable）：功能已全量发布，Flag 值固定为 ON，不再频繁变更。此时应启动“清理倒计时”。
- 废弃（Deprecated）：Flag 标记为待删除，代码中仍存在但不再推荐使用。系统发出清理提醒。
- 清理（Cleanup）：从代码仓库和配置中心彻底移除 Flag 及相关条件分支，完成生命周期闭环。
常见陷阱：许多团队只关注“创建”和“激活”，忽略了“清理”阶段。据统计，超过 40% 的 Feature Flag 在功能全量发布后 6 个月内仍未被删除。这些“僵尸 Flag”不仅增加代码复杂度，还可能在配置迁移时引发意外回滚。
下图展示了 Flag 生命周期各阶段的流转关系与关键动作：
3.3 Flag 命名规范
命名规范是 Feature Flag 治理的“第一道防线”。在自助门户中，Flag 名称不仅是标识符，更承载了归属信息、功能描述与生命周期状态。一个结构化的命名体系可以大幅降低配置冲突与误操作风险。
推荐采用 三段式命名结构：
# 标准格式：{团队}.{功能域}.{描述}
# 示例
team-payment.checkout.new-checkout-flow
team-user.profile.enable-avatar-v2
team-infra.logging.enable-structured-log
# 临时/实验性 Flag 格式：{团队}.{功能域}.tmp.{描述}
team-search.index.tmp.reindex-v3-test
命名规则要点：
- 团队前缀：使用固定缩写（如 team-payment、team-user），避免跨团队命名冲突。
- 功能域：按模块或微服务划分（如 checkout、profile、index），便于按域检索。
- 描述：使用小写字母 + 连字符，清晰表达功能意图（如 new-checkout-flow）。
- 禁止：使用大写字母、下划线、空格、中文或特殊字符。
- 长度限制：建议不超过 64 个字符，确保在配置中心和日志中完整显示。
下表对比了常见的不规范命名与推荐命名，帮助团队快速建立统一标准：
| 不规范命名 | 问题 | 推荐命名 |
|---|---|---|
flag1 |
无意义，无法追溯归属 | team-payment.checkout.new-flow |
NewFeature_TEST |
大小写混用，含下划线 | team-user.profile.enable-avatar-v2 |
紧急回滚开关 |
使用中文，无法跨系统解析 | team-infra.gateway.emergency-rollback |
my_team.my_feature.my_flag |
下划线分隔，与代码风格不一致 | team-search.index.reindex-v3 |
自动化校验：在自助门户中，应内置命名规范校验器。当开发者创建 Flag 时，系统自动检查名称是否符合正则表达式
^[a-z0-9]+(\.[a-z0-9]+)+$，并拒绝不合规的提交。同时，门户应提供“命名模板”下拉选择，引导用户按规范填写。