两阶段名称查找要求模板定义时只解析非依赖名，依赖名推迟到实例化时解析；依赖名需用typename或template显式标注，否则编译失败。
两阶段名称查找是 C++ 模板编译中决定「哪些名字在何时被解析」的核心规则。它不是可选行为，而是标准强制要求：**模板定义时只解析非依赖名（non-dependent names），而依赖名（dependent names）必须推迟到实例化时才查找**。不理解这点，就很容易遇到 error: 'xxx' was not declared in this scope 或静默绑定错误。
什么是依赖名和非依赖名？
判断依据是名字是否依赖于模板参数：
-
T::value、func(t)（其中t是模板参数类型）、this->member—— 都是依赖名，因为它们的含义可能随T改变，必须延迟查找 -
std::vector<int>::size_type</int>、sizeof(int)、全局函数printf—— 是非依赖名，在模板定义时就完成查找 - 特别注意：
Base<t>::foo</t>是依赖名（即使Base是已知类模板），因为foo可能被特化重定义；但Base<int>::foo</int>是非依赖名（int是具体类型）
为什么需要 typename 和 template 关键字？
这是两阶段查找最常踩坑的地方：编译器在第一阶段无法确定某个依赖名是类型还是值，或某个成员调用是函数模板还是普通函数。你必须显式提示：
- 用
typename告诉编译器：后面那个依赖名是个类型 —— 例如typename T::iterator - 用
template告诉编译器：后面那个依赖名是个模板 —— 例如obj.template get<int>()</int> - 漏掉
typename会导致第一阶段报错：「error: need 'typename' before 'T::value_type' because 'T' is a dependent scope」 - 漏掉
template会导致第二阶段解析失败或调用错误重载
常见错误场景与修复示例
下面这段代码在 GCC/Clang 下会编译失败，正是两阶段查找的典型表现：
立即学习“C++免费学习笔记（深入）”；
template <typename T>
struct Wrapper {
void f() {
T::static_func(); // ❌ 错误：T::static_func 是依赖名，但未加 template
typename T::value_type x; // ❌ 错误：缺少 typename
}
};
struct Test { using value_type = int; static void static_func() {} };
Wrapper<Test> w;
正确写法：
template <typename T>
struct Wrapper {
void f() {
T::template static_func(); // ✅ 加 template
typename T::value_type x; // ✅ 加 typename
}
};
另一个陷阱：基类中的依赖名默认不可见，哪怕你写了 using Base<t>::func;</t>，在某些老编译器上仍可能失效 —— 因为 Base<t></t> 是依赖基类，其成员在第一阶段不导入当前作用域。
不同编译器对两阶段查找的执行严格度差异
MSVC 长期默认禁用严格两阶段查找（通过 /permissive- 或 C++20 模式才启用），而 GCC/Clang 默认严格遵循标准。这意味着：
- 一段在 MSVC 上能编译的模板代码，换到 GCC 可能直接报错
- 错误往往出现在模板定义处，而非实例化点 —— 这说明问题出在第一阶段，不是数据类型没传对
- 开启
-fno-delayed-template-parsing（GCC）或/Zc:twoPhase-（MSVC）可强制启用/禁用，但不建议绕过，应修正代码
真正麻烦的不是报错，而是某些依赖名在第一阶段被意外绑定到外层作用域的同名符号，导致行为和预期不一致 —— 这种 bug 很难调试，因为它只在特定特化下触发。
