匿名命名空间 - c++

匿名命名空间（anonymous namespace）

• 有什么用

• 典型写法

• 使用建议

• 匿名命名空间 （anonymous namespace）：namespace { ... }。
  0 放在其中的名字（函数、变量、类型、模板......）都拥有内部链接（internal linkage）------只在当前源文件（translation unit）可见，链接时对外不可见。

有什么用

• 文件私有：把"只在本 .cpp 用"的工具函数、常量、状态变量放进去，避免与其它文件重名/冲突。

• 替代 static（命名空间作用域）：在 C++ 里，static 也能让全局函数/变量变成内部链接；匿名命名空间是现代 C++ 更通用的做法（还能作用于类型/模板，static 不能用于类型）。

• 防 ODR 冲突：每个源文件得到自己唯一的一份实体，互不干扰。

典型写法

// foo.cpp
namespace 
{                 // 有时会加注释 // anon 仅作标注
  constexpr int kBuf = 64;  // 只在本文件可见
  struct LocalState { ... };
  void helper(...) { ... }
}

使用建议

• ✅ 放在 .cpp：封装本文件的私有实现细节。

• ⚠️ 不要放在 .h（除非你刻意想"每个包含该头的 .cpp 都各自生成一份"）：

  每个包含者都会得到独立的类型/变量/函数副本，容易造成体积增大或难以预期的行为。需要在头文件共享的常量/函数，建议用 inline（C++17 起支持 inline 变量/函数）或 extern 声明+单一定义。

• 与 static 区别：两者都能让命名空间作用域的函数/变量变成内部链接；匿名命名空间还能作用于类型/模板，更统一；风格上现代 C++更推荐匿名命名空间。

一句话记忆：namespace {} = 本文件私有作用域；把不想"泄漏到链接层"的东西都塞进去就对了。