模板声明和定义必须放在同一头文件中，否则链接时报错；可通过extern template抑制重复实例化；clang不支持已废弃的export关键字；模板特化须在主模板定义后且使用前声明。
模板声明和定义不能拆到不同文件里
Clang（以及所有标准C++编译器）在编译时无法跨文件解析模板的实例化需求。如果你把 template<typename t> void foo(T);</typename> 声明放在 .h，而定义写在 .cpp 里，链接阶段会报 undefined reference to 'foo<int>()'</int> —— 因为 .cpp 文件单独编译时根本不知道外面谁会用 foo<int></int>，也就不会生成对应实例。
必须把模板的完整定义（声明 + 实现）都放在头文件中，让每个包含它的翻译单元都能看到并按需实例化。
- ✅ 正确做法：全部写在
utils.h里，#include "utils.h"后直接可用 - ❌ 错误做法：声明在
utils.h，定义在utils.cpp - ⚠️ 特殊例外：显式实例化（
template void foo<int>();</int>）可放.cpp，但需确保该实例化语句出现在所有使用点之前，且仅适用于你明确知道要支持的类型列表
如何避免头文件重复包含导致的编译膨胀
模板代码全塞进头文件后，每次 #include 都会触发一遍解析和潜在实例化，大型项目里容易拖慢编译速度。光靠 #pragma once 或卫士宏只能防重复包含，不能阻止重复实例化。
关键不是“不包含”，而是“不重复实例化”。Clang 支持 extern template 声明来抑制局部实例化，把实例化任务集中到某个 .cpp 文件里。
- 在
utils.h中写：extern template void process<int>(int);</int>extern template void process<:string>(std::string);</:string> - 在
utils.cpp中写：template void process<int>(int);</int>template void process<:string>(std::string);</:string> - 这样其他文件包含
utils.h时，只看到声明，不会生成实例；只有utils.cpp真正生成目标码
Clang 对 export 关键字根本不支持
C++03 曾引入 export 关键字试图解决模板分离问题，但实际几乎没人实现，Clang 从一开始就没打算支持它。你在代码里写 export template<class t> class Vec { ... };</class>，Clang 会直接报错：error: 'export' is not supported in this version of Clang。
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
别查文档找开关，也别试 flag，Clang 就是不认这个关键字。它已被 C++11 正式移除，现在所有现代编译器（包括 Clang、GCC、MSVC）都无视它。
依赖 export 是死路，老老实实把定义放头文件，或用 extern template 控制实例化位置。
模板特化必须和主模板在同一个翻译单元可见
如果你写了 template<typename t> struct traits;</typename>，又想在别处特化 traits<int></int>，Clang 要求这个特化声明必须出现在主模板定义之后、且在任何使用 traits<int></int> 的代码之前。否则会报 error: explicit specialization of 'traits' after instantiation。
常见踩坑场景：
- 主模板在
A.h，特化写在B.h，而C.cpp先#include "B.h"再#include "A.h"→ 编译失败 - 特化写在
A.h末尾，但A.h里已有函数模板用到了traits<int></int>→ 顺序错，同样失败
稳妥做法：所有特化紧跟着主模板定义写在同一头文件里，中间不要夹杂其他使用该特化的代码。
