c++ template in .h and .cpp

一、根本原则：模板实例化点必须能看到其完整定义

• 编译器在看到 Foo<int> 这样的用法时，必须立即拿到 template<class T> class Foo { … }; 的完整定义来生成代码（隐式实例化）。

• 如果实例化时看不到定义，就只能等到链接阶段去找预先“烤”好的显式实例化对象（extern template / template class Foo<int>;）。

因此，决定“把模板定义写在 .h 还是 .cpp”的关键就是：你希望使用者隐式实例化，还是只允许显式实例化你列出的那些类型。

二、两种常见组织方式

三、关键语法回顾

// === Foo.h ===
#pragma once
template<typename T>
class Foo {
public:Foo(T v);        // 仅声明void bar();
};
extern template class Foo<int>;      // 可选：阻止其他翻译单元再次隐式实例化 Foo<int>// === Foo.cpp ===
#include "Foo.h"template<typename T>
Foo<T>::Foo(T v) { /*...*/ }template<typename T>
void Foo<T>::bar() { /*...*/ }// 显式实例化
template class Foo<int>;
template class Foo<double>;

四、两种策略的深度对比