匿名命名空间(anonymous namespace)
-
匿名命名空间 (anonymous namespace):namespace { ... }。
0 放在其中的名字(函数、变量、类型、模板......)都拥有内部链接(internal linkage)------只在当前源文件(translation unit)可见,链接时对外不可见。
有什么用
-
文件私有:把"只在本 .cpp 用"的工具函数、常量、状态变量放进去,避免与其它文件重名/冲突。
-
替代 static(命名空间作用域):在 C++ 里,static 也能让全局函数/变量变成内部链接;匿名命名空间是现代 C++ 更通用的做法(还能作用于类型/模板,static 不能用于类型)。
-
防 ODR 冲突:每个源文件得到自己唯一的一份实体,互不干扰。
典型写法
cpp
// foo.cpp
namespace
{ // 有时会加注释 // anon 仅作标注
constexpr int kBuf = 64; // 只在本文件可见
struct LocalState { ... };
void helper(...) { ... }
}
使用建议
-
✅ 放在 .cpp:封装本文件的私有实现细节。
-
⚠️ 不要放在 .h(除非你刻意想"每个包含该头的 .cpp 都各自生成一份"):
每个包含者都会得到独立的类型/变量/函数副本,容易造成体积增大或难以预期的行为。需要在头文件共享的常量/函数,建议用 inline(C++17 起支持 inline 变量/函数)或 extern 声明+单一定义。
-
与 static 区别:两者都能让命名空间作用域的函数/变量变成内部链接;匿名命名空间还能作用于类型/模板,更统一;风格上现代 C++更推荐匿名命名空间。
一句话记忆:namespace {} = 本文件私有作用域;把不想"泄漏到链接层"的东西都塞进去就对了。