命名空间命名法采用“域:模块:行为”三段式结构，如app:tab-change，明确标识触发方、功能域与事件本质，并配套统一payload契约、通配符订阅及ci/cd自动化校验，实现事件的语义化、可维护与安全管控。
命名空间命名法（如 app:tab-change）是企业级自定义事件设计中兼顾可读性、可维护性与协作安全的关键实践。它不只是加个前缀，而是通过结构化命名建立语义边界和生命周期归属，避免跨模块事件污染和调试盲区。
明确命名空间层级与业务语义
命名空间应体现“谁触发、在哪发生、为何触发”三层含义，推荐采用 域:模块:行为 三段式结构：
-
域（Domain）：标识系统层级或产品线，如
app（主应用）、admin（管理后台）、widget（嵌入式组件） -
模块（Module）：对应功能域或技术边界，如
tab、form、auth、notification -
行为（Action）：使用动宾短语描述事件本质，如
tab-change、form-submit-success、auth-token-expired
示例：admin:log-export:started 比 exportStart 更清晰表达触发方（admin 系统）、对象（日志导出）、状态（开始）。
统一事件格式与数据契约
仅靠命名不够，需配套约定事件 payload 结构，确保监听方无需猜测字段含义：
- 所有命名空间事件统一携带
namespace字段（值同事件名），便于中间件识别路由 - 强制包含
timestamp和source（如user-menu或auto-sync），支撑审计与问题定位 - 错误类事件以
-error结尾（如app:api:fetch-error），并要求 payload 含error对象和retryable布尔值
这样，当 app:tab-change 被触发时，payload 可为：{ namespace: "app:tab-change", tabId: "dashboard", prevTab: "settings", timestamp: 1747017120123 }
配合事件总线实现精准订阅与隔离
在 Vue、React 或自研事件总线中，利用命名空间支持通配符的特性做分层管控：
- 组件只监听自己关心的精确命名空间：
bus.on('app:tab-change', handler) - 监控模块可监听全量 app 事件：
bus.on('app:*', auditHandler) - 销毁组件时批量解绑：
bus.off('app:tab-*')，避免内存泄漏 - 测试环境可拦截
app:auth:*事件模拟登录态变更，不侵入业务逻辑
纳入工程规范与自动化检查
命名空间不是开发者的自由发挥项，需成为 CI/CD 流程中的可验证规则：
- 在 ESLint 或自定义 lint 工具中校验事件字符串是否匹配正则
^[a-z]+:[a-z]+:[a-z]+(-[a-z]+)*$ - CI 阶段扫描源码，禁止出现未注册的命名空间（如通过
EVENT_NAMESPACES = ['app:tab', 'admin:log']白名单管理） - 文档站点自动生成事件字典页，每个命名空间附带触发时机、参数说明与典型用例
