Mac平台C++项目中静态库静态成员多副本问题及单实例实现方案

你遇到的核心是符号重复定义导致的多实例问题：静态库libA.a被间接或直接链接到B.framework和exe两个模块中，使得静态成员myVar在两个模块各自生成了独立副本。以下是具体解决办法：

• 避免重复链接静态库
  检查exe的构建配置，确保它仅通过动态链接B.framework来使用MyClass的功能，不要将libA.a直接或间接加入exe的依赖列表。这样exe只会引用框架内的myVar符号，不会生成本地副本。

• 控制符号可见性
  在Mac C++编译体系中，通过符号可见性控制确保myVar仅在B.framework中全局导出：

  1. 代码层面显式标记符号可见性：

     class MyClass {
         static MyType* __attribute__((visibility("default"))) myVar;
     public:
         void print() {
             // 打印&myVar地址
         }
     };
     

  2. 编译libA.a时添加全局隐藏选项：-fvisibility=hidden，仅让标记为default的符号（如myVar）对外可见。这样链接到B.framework后，exe只能引用框架内的myVar，无法生成本地实例。

• 改用单例模式实现
  用静态局部变量的单例逻辑替代直接的静态成员，利用C++11及以后标准中静态局部变量的线程安全初始化特性，确保全局唯一实例：

  class MyClass {
  private:
      static MyType* getMyVarInstance() {
          static MyType* instance = new MyType();
          return instance;
      }
  public:
      void print() {
          MyType* myVar = getMyVarInstance();
          // 打印&myVar地址
      }
  };
  

  这种方式不受链接方式影响，无论从框架还是exe调用，都会获取同一个实例。

• 调整框架链接参数
  构建B.framework时添加链接选项-single_module，确保框架内的符号统一在一个模块中，避免符号被拆分导致的多实例问题。

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