匿名命名空间用于实现文件作用域的内部链接，替代static全局变量/函数，支持类型定义且语义统一；它使符号仅在当前编译单元可见，避免命名冲突，但不可用于头文件。
匿名命名空间（anonymous namespace）在 C++ 中主要用来实现**文件作用域的内部链接（internal linkage）**，替代老式 C 风格的 static 全局变量和函数，让符号只在当前编译单元内可见，避免与其他文件同名符号冲突。
匿名命名空间的作用：限制符号可见性
它本质是编译器自动生成一个唯一名称的命名空间（比如 namespace __unique_namespace_123 {...}），并隐式地用 using 引入当前作用域。效果等价于给每个声明加 static，但更现代、更统一、更符合 C++ 语义。
适用于：
- 不希望被其他文件访问的辅助函数（如解析逻辑、工具函数）
- 仅本文件使用的常量或配置数据（如默认超时、调试开关）
- 实现细节类（如私有策略类、状态机内部类）
对比 static 全局变量/函数
static 在全局作用域中也能实现内部链接，但它在 C++ 中存在两个明显短板：
立即学习“C++免费学习笔记（深入）”；
-
不能用于类型定义：你不能写
static class Helper { ... };—— 语法错误；而匿名命名空间里可以自由定义 class、struct、enum、template 等 -
语义割裂：对变量/函数用
static，对类型却必须靠命名空间封装，风格不统一；匿名命名空间一套机制全搞定
所以 C++ 标准推荐：**优先用匿名命名空间替代全局 static**。
典型写法与注意事项
基本结构如下：
namespace {
const int kDefaultTimeout = 5000;
bool IsDebugMode() { return true; }
class FileCache { /* ... */ };
} // 匿名命名空间结束
注意点：
- 匿名命名空间里的内容**不能在外部通过任何方式访问**（包括友元、ADL、模板实参推导等）
- 可以嵌套，但通常没必要；多个匿名命名空间在同一个文件中会被合并为同一个作用域
- 头文件中不要使用匿名命名空间（会导致每个包含它的 .cpp 文件都生成一份副本，违反 ODR，且可能引发意外行为）
替代方案：inline 变量（C++17 起）
对于需要“定义一次、多处使用”的 内联常量（尤其是 constexpr），可考虑 inline constexpr：
// 头文件中安全使用 inline constexpr int kMaxRetries = 3;
它支持 ODR，允许在多个编译单元中定义同一符号，且保证唯一实体。但这不是匿名命名空间的替代，而是不同场景：前者解决“内部链接 + 类型支持”，后者解决“跨文件常量共享”。
基本上就这些。用好匿名命名空间，能让代码更干净、模块边界更清晰，也更符合现代 C++ 的组织习惯。
