两阶段查找是C++模板编译中强制的名称解析机制：第一阶段在模板定义时查找非依赖名并立即报错；第二阶段在实例化时查找依赖名，支持ADL和基类成员访问，兼顾早期错误检测与上下文相关语义。
什么是两阶段查找（Two-Phase Lookup）
两阶段查找是C++模板编译过程中，针对名称（name）解析所采用的特殊规则，核心在于：模板定义时和实例化时，对不同类别的名称分两个阶段进行查找。它不是语法糖，而是标准强制要求的语义机制，直接影响模板能否通过编译、调用哪个重载函数、是否能访问基类成员等关键行为。
第一阶段：模板定义时的非依赖名查找
在声明或定义模板（如 template
- 例如：std::cout 中的 std::cout 和 是非依赖名，此时就会按普通作用域规则查找（比如看是否 using 了命名空间、是否有可见声明）
- 如果此时找不到，编译器立刻报错——不会等到实例化才检查
- 类模板中，基类作用域在第一阶段不可见（因为基类可能依赖 T，比如 template
struct D : B 中的 x 若未显式指明来源，第一阶段查不到）{ void g() { x = 1; } };
第二阶段：模板实例化时的依赖名查找
当模板被实际具现化（如 f
- 形如 T::type、p->func()（若 p 类型含模板参数）、f(t)（t 是模板参数类型）等
- 此时 ADL（Argument-Dependent Lookup）生效：会搜索实参类型的关联命名空间
- 基类中的成员（如 B
::value ）只有在使用 this->value 或 B::value 显式限定后，才能在第二阶段被找到 - typename 和 template 关键字就是为帮编译器在第一阶段正确识别依赖类型/模板而存在的（否则 T::iterator 可能被误认为静态数据成员）
为什么需要两阶段？根本动机是什么
本质是为了平衡“早期错误检测”和“依赖上下文的正确性”。
立即学习“C++免费学习笔记（深入）”；
- 若全部推迟到实例化时查，很多明显错误（如拼错标准库函数名）要等到模板被某处调用才暴露，调试成本高
- 但若所有名都在定义时查，又无法支持“依赖实参的重载选择”（比如 swap(a, b) 应该调用用户为自定义类型特化的版本，这只能在知道 a、b 真实类型后通过 ADL 决定）
- 所以 C++ 把“确定语法结构”（第一阶段）和“绑定具体含义”（第二阶段）拆开，既保安全又保灵活性
