C++模板显式实例化后const对象调用get函数出现未定义引用错误

你遇到的这个链接错误，核心原因是显式实例化模板类时，没有包含const版本的get成员函数，咱们一步步拆解：

先回顾你的代码场景 #

首先你在头文件里声明了模板类RessourceHolder，包含两个重载的get方法：

template <typename Ressource, typename Identifier>
class RessourceHolder {
public:
    void load(Identifier id, const std::string& filename);
    Ressource& get(Identifier id);               // 非const版本
    const Ressource& get(Identifier id) const;   // const版本
private:
    void insert(Identifier id, std::unique_ptr<Ressource> resource);
    std::map<Identifier, std::unique_ptr<Ressource>> mRessourceMap;
};

你在cpp文件里对RessourceHolder<sf::Texture, Textures::ID>做了显式实例化，并typedef为TextureHolder，把模板类的实现都放在了这个cpp文件中。

之后你定义了const TextureHolder对象并在Agent类中使用：

// .hpp中的Agent类
class Agent{
public :
    Agent(TextureHolder const& textures);
    void setTexture();
    const TextureHolder& mTextures; // 带const限定的成员
private :
    sf::Sprite mSprite;
};

// .cpp中的实现
Agent::Agent(TextureHolder const& textures) : mTextures(textures){
    setTexture();
}
void Agent::setTexture(){
    // 调用const版本的get方法
    mSprite.setTexture(mTextures.get(toTextureID(mType))); 
}

此时链接器报错：undefined reference to RessourceHolder<sf::Texture, Textures::ID>::get(Textures::ID) const，但去掉mTextures的const限定后，错误就消失了。

错误原因拆解 #

模板类的成员函数有个关键特性：只有当它被实际调用，或者被显式实例化时，编译器才会生成对应的机器码。你用显式实例化的方式把模板实现放在cpp文件里，意味着必须确保所有用到的成员函数都被显式实例化。

在你的场景中，显式实例化操作只生成了非const版本的get（以及其他被用到的非const成员），但const版本的get没有被实例化。当你通过const TextureHolder对象调用get时，编译器会匹配const重载版本，但链接器在目标文件里找不到这个版本的实现，于是抛出了未定义引用错误。

而当你去掉mTextures的const限定后，调用的是非const版本的get——这个版本已经被显式实例化了，链接器能找到对应的代码，错误自然就消失了。

修复方案 #

要解决这个问题，你需要确保const版本的get也被显式实例化，有两种常用方式：

• 显式实例化整个模板类：在cpp文件中添加一行代码，这样所有成员函数都会被实例化：

  template class RessourceHolder<sf::Texture, Textures::ID>;
  

• 单独显式实例化const版本的get：如果只想实例化特定成员函数，可以单独声明：

  template const sf::Texture& RessourceHolder<sf::Texture, Textures::ID>::get(Textures::ID) const;
  

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