C++如何在多个头文件中使用同一对象实例并解决循环依赖问题

你遇到的重复定义报错本质是两个问题叠加导致的：

• 你把全局变量addressHelper的定义写在了gui.h头文件中，C++中头文件会被所有引用它的编译单元（.cpp文件）展开，相当于每个引用了gui.h的cpp都会生成一个addressHelper实例，链接时就会触发重复定义错误，哪怕没有循环依赖也会报错。
• 其次是gui.h和world.h的循环依赖，加剧了头文件展开的冲突。

两种方案都完全满足需求：对象仅实例化一次可全局复用，更新实例变量后所有调用位置都能拿到最新值。

方案1：修正全局变量定义位置（改动最小） #

步骤1：移动全局实例定义到cpp文件 #

删掉gui.h中AddressHelper* addressHelper = new AddressHelper(GetCurrentProcessId());这行代码，将这行定义放到gui.cpp的顶部（要放在所有使用该变量的代码之前）：

// gui.cpp 新增内容
#include "gui.h"
AddressHelper* addressHelper = new AddressHelper(GetCurrentProcessId());

此时Globals.h中的extern声明仍然有效，所有引用Globals.h的文件都能正常访问同一个全局实例。

步骤2：解开循环依赖 #

world.h中直接引用#include "Globals.h"即可，因为Globals.h只包含AddressHelper的头文件和extern声明，不会反向引用gui.h，循环依赖自然解除。

方案2：单例模式改造（更稳妥，无全局变量污染） #

直接修改AddressHelper类为单例模式，彻底不需要单独声明全局变量，也不受循环依赖影响：

// 修改后的AddressHelper.h
class AddressHelper {
private:
    uint32_t pid;
    DWORD_PTR baseAddressPtr;
    // 构造函数私有化，禁止外部手动实例化
    AddressHelper(uint32_t pid) {
        this->pid = pid;
        this->baseAddressPtr = this->GetProcessBaseAddress(pid);
    }
    // 禁用拷贝、移动构造，避免生成额外实例
    AddressHelper(const AddressHelper&) = delete;
    AddressHelper& operator=(const AddressHelper&) = delete;
    AddressHelper(AddressHelper&&) = delete;
    AddressHelper& operator=(AddressHelper&&) = delete;

public:
    // 全局唯一实例获取接口
    static AddressHelper& getInstance() {
        static AddressHelper instance(GetCurrentProcessId());
        return instance;
    }

    DWORD_PTR GetProcessBaseAddress(DWORD processID)
    {
        DWORD_PTR   base_address = 0;
        //... 原有逻辑不变
        return base_address;
    }
    DWORD_PTR GetBaseAddress() {
        return this->baseAddressPtr;
    }

    void SetBaseAddress() {
        this->baseAddressPtr = GetProcessBaseAddress(pid);
    }
};

使用时不需要引入Globals.h，在任意头文件、cpp文件中直接调用即可：

// 示例调用，任意位置都可以写
AddressHelper::getInstance().GetBaseAddress() + 0xb81074;
// 更新值后所有调用位置都可见
AddressHelper::getInstance().SetBaseAddress();

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