如何避免每次编译项目时重新编译特定C++模板函数？

你之前的问题核心是：只做显式实例化但没告诉main.cpp不需要再实例化模板，导致编译器仍会重复生成foo<3>()的代码。解决方法需要配合extern模板声明，具体步骤如下：

1. 修改头文件foo.hpp，添加extern实例声明 #

在模板定义前，加入extern template声明，告诉编译器foo<3>()的实例已经在其他编译单元中存在，当前文件编译时无需再实例化：

// foo.hpp
extern template void foo<3>();

template<int a>
void foo()
{
    // Complex function
}

2. 保留precompiled.cpp的显式实例化 #

这个文件负责生成foo<3>()的实际编译代码，内容不变：

// precompiled.cpp
#include "foo.hpp"

template void foo<3>();

3. 执行分步骤编译 #

• 先编译precompiled.cpp（只需要执行一次，除非foo.hpp或precompiled.cpp修改）：

  g++ -c precompiled.cpp
  

• 再编译main.cpp并链接已生成的precompiled.o（每次修改main.cpp后仅执行这一步，速度会大幅提升）：

  g++ main.cpp precompiled.o -o main
  

原理说明 #

没有extern声明时，main.cpp包含foo.hpp后，编译器看到模板的完整定义，会默认在当前编译单元实例化foo<3>()，即使已经有precompiled.o里的实例。extern模板声明会抑制当前单元的实例化，让编译器直接链接外部已有的实例，从而避免重复编译耗时的模板代码。

内容的提问来源于stack exchange，提问作者SirVivor