两阶段名称查找指C++模板中名称解析分两步：第一阶段在模板定义时解析非依赖名称，如全局变量和普通类型；第二阶段在模板实例化时解析依赖名称，即涉及模板参数的名称，如T::value_type或依赖类型的函数调用，此时通过ADL查找匹配的重载函数。
在C++模板中，"两阶段名称查找"（Two-phase name lookup）是指在模板定义和模板实例化过程中，编译器对名称的解析分为两个阶段进行。这个机制主要出现在支持依赖类型（dependent types）和非依赖类型（non-dependent types）的上下文中，尤其与类模板或函数模板中的名字解析有关。
什么是两阶段名称查找
当编译器处理一个类模板或函数模板时，它需要决定哪些名称是在模板定义时就能确定的，哪些必须等到模板被具体实例化时才能确定。C++标准规定了名称查找的两个阶段：
- 第一阶段：模板定义时 —— 编译器检查模板语法，并解析所有“非依赖名称”（non-dependent names）。这些名称不依赖于模板参数，可以在模板定义处直接查找其含义。
-
第二阶段：模板实例化时 —— 当模板被具体实例化（如
vector），编译器再次查找“依赖名称”（dependent names），即那些依赖于模板参数的名称，此时才能确定其实际意义。
非依赖名称 vs 依赖名称
理解两阶段查找的关键是区分两种名称：
- 非依赖名称：不依赖模板参数的名称。例如全局函数、当前作用域中的变量、普通类型等。它们在第一阶段就完成查找。
-
依赖名称：涉及模板参数的表达式或类型。例如
T::value_type、std::is_integral_v或t.func()（其中 t 是 T 类型的对象）。这些名称的含义取决于具体的模板实参，因此推迟到实例化时才查找。
例如：
立即学习“C++免费学习笔记（深入）”；
templatevoid foo() { cout << "Hello"; // 'cout' 是非依赖名称，在定义时查找 T::do_something(); // 'do_something' 是依赖名称，在实例化时查找 }
这里，cout 属于非依赖名称，编译器在看到模板定义时就会尝试查找它所在的命名空间（通常需 using std::cout 或写全名）。而 T::do_something() 是依赖名称，只有当知道 T 具体是什么类时才能确定是否存在该静态成员函数。
依赖类型中的嵌套名称必须用 typename 或 template 显式说明
对于依赖类型中出现的嵌套类型或模板，必须使用 typename 或 template 关键字来帮助编译器正确解析。
- 使用
typename声明某个依赖名称是一个类型：
templateclass MyClass { typename T::iterator it; // 必须加 typename，否则编译器不知道它是类型 };
- 使用
template声明某个成员是模板：
templatevoid call(T& obj) { obj.template get_ptr (); // 指明 get_ptr 是一个模板函数 }
如果不加这些关键字，编译器会按照非依赖名称的方式解析，可能误判为变量或普通函数，导致编译错误。
ADL（参数依赖查找）在第二阶段起作用
对于函数调用，如果函数名依赖于模板参数的类型，那么会在实例化时通过 ADL（Argument-Dependent Lookup）查找对应的重载函数。
namespace NS {
struct A {};
void func(A) {}
}
template
void wrapper(T t) {
func(t); // func 是依赖名称，实例化时通过 ADL 找到 NS::func
}
上面的例子中，func(t) 中的 func 是依赖名称，因为它依赖于参数 t 的类型。编译器不会在模板定义时查找 func，而是在实例化 wrapper(NS::A{}) 时，根据 t 的类型所在命名空间 NS 来查找合适的 func。
基本上就这些。两阶段查找确保了模板既能早期发现部分错误，又能灵活适应不同的模板实参。理解它有助于写出更清晰、可编译的模板代码，避免常见的名称解析问题。
