C++命名空间¶

与模块化相关：头文件 · 头文件中的定义与链接：内联与ODR · 类与封装：C++类 & 模板

命名空间（namespace）是 C++ 里最常用的模块化与防冲突机制。标准库几乎全部在 std 中；第三方库常用 libname:: 的形式；自研库则通常用项目名作为顶层命名空间（如 mylib::header）。

基本语法¶

定义与嵌套¶

namespace netstack {
  void Foo();
}

// C++17：嵌套命名空间简写
namespace netstack::header {
  class IPv4Header { /* ... */ };
}

上式等价于：

namespace netstack {
  namespace header {
    class IPv4Header { /* ... */ };
  }
}

使用限定名¶

netstack::header::IPv4Header hdr;

声明与定义分离¶

头文件中声明：

namespace netstack::header {
  class IPv4Header;
  void Encode(/* ... */);
}

实现文件中再次打开同一 namespace，写成员函数或自由函数定义——与 头文件 中的多文件分工一致。

为什么要用 namespace¶

C++ 没有 Java/C# 那种「一个目录对应一个包」的硬性规则；目录结构是团队约定，namespace 是语言层面的名字隔离。

常见用法¶

匿名 namespace（文件内链接）¶

// example.cc
namespace {

uint16_t ReadBE16(const uint8_t* p) {
  return (static_cast<uint16_t>(p[0]) << 8) | p[1];
}

}  // namespace

• 大括号内不写名字 → 匿名 namespace。

• 其中符号仅在当前翻译单元可见，效果类似 C 的 static 文件作用域函数。

• 适合实现文件里的内部辅助函数，不进入库的对外 API。

也可使用具名子空间 mylib::detail 表达「实现细节」，语义更清晰，但链接属性需配合 static/匿名 namespace 或仅在一个实现文件中定义，避免 ODR 问题。

using 与 using namespace¶

using netstack::header::IPv4Header;   // 引入单个名字
using namespace std;                  // 引入整个 std

内联 namespace（C++11）¶

namespace mylib {
  inline namespace v1 {
    void Api();
  }
}
// 调用 mylib::Api() 实际解析到 v1::Api()

用于版本演进：对外仍写 mylib::Api()，内部可切换 v2 实现。标准库中亦有类似用法。

namespace 与 class 的分工¶

类型放在 namespace mylib::header 表示模块归属；类自身的 public / private 才是对象封装。

与头文件、链接的关系¶

• 同一 namespace 可分布在多个 头文件 / 实现文件，链接器合并为同一组符号。

• 在 namespace 内的非 inline 函数若在每个实现文件中各写一份定义 → 违反 ODR。应：声明在头、定义在一个实现文件；或头文件中 inline / constexpr（C++17 起 inline 变量同理）。

• 头文件中的 inline constexpr 常量（如协议偏移 kVersIHL）可在多翻译单元共享一份定义。

ADL（参数依赖查找）¶

调用 foo(bar) 时，除通常作用域查找外，编译器还会在 bar 的类型所在的 namespace 中查找 foo，称为 ADL（Argument-Dependent Lookup，又称 Koenig 查找）。

namespace netstack {
  struct Address { /* ... */ };
  void Print(const Address&);
}

void Use(const netstack::Address& a) {
  Print(a);  // 可能找到 netstack::Print，即使当前作用域无 using
}

实践要点：

• std::swap、std::begin / std::end 与自定义类型配合时依赖 ADL。

• 运算符重载（如 operator<<）通常与类型放在同一 namespace，才能在被调用处被正确找到。

工程实践建议¶

1. 顶层一个库名：如 netstack，与项目/安装前缀一致。

2. 按层或子系统嵌套：header、link、stack、net::ipv4 等，与 include/mylib/... 目录约定对齐（非语言强制）。

3. 对外 API：调用方使用完整限定名，或在局部 using 单个类型；公共头中不要 using namespace mylib。

4. 实现细节：.cc 内匿名 namespace，或 mylib::detail + 仅内部 include 的头文件。

示例层次（netstack）：

netstack::              # 库根
  header::              # 报文头编解码
  link::                # 链路层
  stack::               # 协议栈核心
  net::ipv4::           # 网络层 IPv4

与其他语言的对比¶