如何拆分单一大源文件的命名空间至多文件并保留原有优势？

要同时保留你提到的两个优势，有两种可行的方案，具体取决于你的C++版本：

方案一：兼容C++17之前的版本（extern + 私有头文件） #

这种方式通过不对外公开的私有头文件隔离内部变量的声明，结合extern实现多个源文件共享变量，同时保证外部无法访问：

1. 保持公共头文件Foo.h不变：

namespace foo{
  void increase();
  void decrease();
}

2. 创建仅内部使用的私有头文件FooPrivate.h（不对外发布，仅在内部源文件中包含）：

namespace foo{
  // 声明共享变量，外部无法通过公共头文件看到这些声明
  extern int foo;
  extern int bar;
}

3. 创建单独的源文件FooState.cpp定义这些变量：

#include "FooPrivate.h"

namespace foo{
  int foo = 0;
  int bar = 0;
}

4. 修改拆分后的源文件，包含私有头文件以访问变量：

// FooIncremental.cpp
#include "Foo.h"
#include "FooPrivate.h"

namespace foo{
  void increase(){
    bar++;
    foo++;
  }
}

// FooDecremental.cpp
#include "Foo.h"
#include "FooPrivate.h"

namespace foo{
  void decrease(){
    bar--;
    foo--;
  }
}

优势验证： #

• 内部可见性：外部代码只能包含Foo.h，无法访问foo::foo和foo::bar（因为它们的声明仅存在于私有头文件）。
• 编译效率：修改变量的初始值或内部逻辑时，仅需编译FooState.cpp或对应的实现文件，依赖Foo.h的其他文件无需重新编译。

方案二：C++17及以上版本（inline变量 + 内部命名空间） #

利用C++17引入的inline变量特性，无需额外的源文件，直接在私有头文件中定义共享变量：

1. 公共头文件Foo.h保持不变：

namespace foo{
  void increase();
  void decrease();
}

2. 创建私有头文件FooPrivate.h，用内部命名空间包裹inline变量：

namespace foo{
  // 内部命名空间，仅内部代码可见
  namespace detail{
    // inline变量支持在多个翻译单元中定义，不会引发链接冲突
    inline int foo = 0;
    inline int bar = 0;
  }
}

3. 修改拆分后的源文件，通过内部命名空间访问变量：

// FooIncremental.cpp
#include "Foo.h"
#include "FooPrivate.h"

namespace foo{
  void increase(){
    detail::bar++;
    detail::foo++;
  }
}

// FooDecremental.cpp
#include "Foo.h"
#include "FooPrivate.h"

namespace foo{
  void decrease(){
    detail::bar--;
    detail::foo--;
  }
}

优势验证： #

• 内部可见性：外部代码无法访问foo::detail命名空间下的变量，因为私有头文件不对外暴露。
• 编译效率：修改变量或内部逻辑时，仅需编译对应的实现文件，公共头文件无需改动，其他依赖文件无需重新编译。

内容的提问来源于stack exchange，提问作者João Schmidt