两阶段名称查找是C++模板编译中分两阶段解析名字的规则：第一阶段在模板定义时查找非依赖名字并立即报错；第二阶段在实例化时查找依赖名字，支持ADL和特化。
两阶段名称查找是什么
两阶段名称查找是 C++ 模板编译过程中对名字（标识符）进行解析的特殊规则，核心在于：模板定义时和实例化时，分两个阶段查找未依赖的名字（non-dependent names）和依赖的名字（dependent names）。
第一阶段：模板定义时查找非依赖名字
编译器在看到模板定义（比如 template
- 如果此时找不到，直接报错，不会等到实例化
- 查到的名字绑定到定义时的作用域，后续实例化不会改变它
- 例如：std::cout 中的 std::cout 和 都是非依赖的，必须在模板定义处可见
第二阶段：模板实例化时查找依赖名字
只有名字显式依赖模板参数（比如 T::value、f(t) 中的 f 如果 t 是模板参数类型），才会推迟到实例化时才查找。
- 依赖名字的查找发生在实例化点（point of instantiation），此时实参类型已知，ADL（参数依赖查找）和当前上下文都生效
- typename T::type 必须加 typename，因为编译器此时还不知道它是不是类型
-
template 关键字用于消除歧义，如 obj.template func
()
为什么需要两阶段查找
它保证了模板的“定义即检查”原则：错误尽量早暴露；同时支持特化和 ADL 的灵活性——比如为自定义类型重载 operator，只有实例化时才能参与查找。
立即学习“C++免费学习笔记（深入）”；
- 避免“先定义后补声明”的陷阱：非依赖名不能靠后面加声明来修复
- 防止模板被意外绑定到错误作用域中的同名实体
- 是 SFINAE、concepts 前置约束等机制的底层基础
基本上就这些。理解两阶段查找，是写出可维护模板代码、读懂编译错误、正确使用 typename 和 template 的关键。不复杂但容易忽略。
