访问extern bool时出现Undefined symbol错误，求排查原因

代码场景 #

driver.h #

namespace org::lib{
  extern bool masterBool;
}

library.h #

namespace {
    bool masterBool = false;
    std::string otherFunction(){ 
        //....
    }
}

driver.cpp #

#include "driver.h"
#include "library.h"

namespace org::lib{

 void function(){
     otherFunction();
     if (masterBool){
        //.....
     }
 }
}

问题 #

编译driver.cpp时出现未定义符号错误：org::lib::masterBool，但调用otherFunction()却无报错，二者均定义在library.h的匿名命名空间中，问题出在哪里？

原因分析 #

1. 匿名命名空间的核心特性：匿名命名空间内的成员，作用域仅限当前翻译单元（即包含该头文件的单个.cpp文件），编译器会为每个翻译单元生成唯一的匿名命名空间标识，这意味着每个包含library.h的文件都拥有独立的masterBool和otherFunction副本。

2. masterBool的声明与定义完全脱节：

   • driver.h中声明的是org::lib命名空间下的extern bool masterBool，编译器会在全局作用域中寻找org::lib::masterBool的定义。
   • 但library.h里的masterBool属于匿名命名空间，和org::lib是两个完全无关的作用域，编译器找不到匹配的定义，因此报未定义符号错误。

3. otherFunction()能正常调用的逻辑：

   • 当driver.cpp包含library.h时，匿名命名空间的otherFunction()会被引入当前翻译单元的全局作用域（匿名命名空间成员的可见性等价于全局静态变量/函数）。
   • 在org::lib::function()中调用otherFunction()时，编译器会先在当前org::lib作用域查找，找不到就向外层全局作用域查找，最终匹配到匿名命名空间中的otherFunction()，因此能正常编译。

修复方案 #

方案一：统一命名空间（推荐） #

将library.h中的成员移到org::lib命名空间下，与声明保持一致：

namespace org::lib {
    // 如果需要跨多个翻译单元共享，保留extern声明并在某.cpp文件中定义；否则加inline避免重复定义
    inline bool masterBool = false;
    std::string otherFunction(){ 
        //....
    }
}

同时可根据需求调整driver.h的extern声明：若用inline定义，可移除driver.h中的声明；若需跨单元共享，保留extern声明并在单独的.cpp文件中定义masterBool。

方案二：通过函数接口访问匿名命名空间成员 #

若要保留匿名命名空间，由于匿名成员无法被外部extern声明引用，可添加访问函数封装masterBool：
在library.h中修改：

namespace {
    bool masterBool = false;
    std::string otherFunction(){ 
        //....
    }
    bool getMasterBool() { return masterBool; }
}

然后在driver.cpp中调用getMasterBool()代替直接访问masterBool：

namespace org::lib{
 void function(){
     otherFunction();
     if (getMasterBool()){
        //.....
     }
 }
}

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