真正有效的 DOM 寻址收拢是建立有边界、可验证、按需触发的寻址层，核心为约定先行、封装隔离、延迟执行，通过语义化命名、集中配置、懒加载寻址器及渐进迁移实现稳定查找到查得稳。
直接把两百个散落的 querySelector 全局搜索替换为一个函数调用，不仅治标不治本，还容易引入定位错误或遗漏动态节点。真正有效的收拢，是建立一套有边界、可验证、按需触发的 DOM 寻址层，核心在于“约定先行、封装隔离、延迟执行”。
定义统一寻址契约与命名空间
先划清责任边界：不是所有 DOM 查找都该进这一层，只收拢业务强相关、复用率高、结构稳定的节点。比如表单字段、操作按钮、状态容器这类高频访问目标。
- 用语义化前缀区分用途，例如
ui:loginForm、data:orderList、ctrl:submitBtn，避免和 CSS 类名冲突 - 所有 selector 字符串集中注册在配置对象里，不写死在业务逻辑中
- 支持层级路径语法（如
page:dashboard > stats:total），便于后期映射到模块化组件结构
封装懒加载式寻址器（Lazy Selector）
不一上来就执行查询，而是返回一个带缓存、可重试、可调试的寻址函数。它只在首次调用时真正执行 querySelector，后续复用缓存结果；若节点尚未挂载，则自动监听 DOMContentLoaded 或 MutationObserver 延迟获取。
- 提供
get(selector)主方法，返回Element | null，失败时记录 warning 而非抛错 - 暴露
force()强制刷新缓存，用于测试或动态 DOM 场景 - 内部自动补全
document上下文，也支持传入任意父容器作作用域
渐进迁移策略：从“查得到”到“查得稳”
不追求一次性改完，而是分三类处理现有调用点：
-
静态节点（如页头、侧边栏）：直接替换成
Dom.find('ui:header')，加单元测试验证返回值类型和存在性 -
动态列表项（如渲染后的商品卡片）：改用
Dom.findAll('data:productItem')，并配合Dom.watch('data:productList', callback)监听新增 -
临时/实验性查找（如调试用的 console 查询）：保留原生写法，但加注释标记
// TODO: migrate to Dom.find('debug:temp')
配套可观测性与降级机制
收拢之后必须能看清“谁在什么时候查了什么”，否则等于黑盒转移问题。
- 开启开发模式时，自动打印每次寻址的耗时、上下文、是否命中缓存
- 对高频未命中 selector（如连续 3 次返回 null）触发控制台提醒，并附建议修复路径
- 提供全局降级开关
Dom.disableCache = true，便于排查缓存导致的 stale node 问题
