C++中namespace用于定义作用域、避免名字冲突，无运行时行为；需用namespace关键字声明，支持嵌套与续写，访问用::、using声明或using指令，匿名命名空间提供内部链接。
在 C++ 中，namespace 不是用来“引用”的，而是用来**定义作用域、避免名字冲突**的机制。你不能像 Python 的 import 或 JS 的 import 那样“导入”一个命名空间——它没有运行时加载行为，只有编译期作用域控制。
如何正确定义命名空间
命名空间必须用 namespace 关键字声明，名称可嵌套，但不能重复定义（除非是续写同一命名空间）：
namespace math {
const double PI = 3.14159;
int add(int a, int b) { return a + b; }
}
namespace math::utils { // C++17 起支持嵌套语法（等价于 namespace math { namespace utils { ... } }）
void log() { / ... / }
}
- 空命名空间
namespace {}是合法的，用于匿名命名空间（仅当前翻译单元可见） - 同一个命名空间可在多个文件或多次出现，编译器会自动合并——这是“续写”，不是重定义
- 命名空间名不能是关键字（如
namespace class { ... }是错的） - 不要在头文件里用
using namespace xxx;，会污染包含该头的所有源文件
如何访问命名空间里的成员
有三种方式，推荐程度从高到低：
-
作用域解析运算符
::：最明确、无歧义，适合频繁使用或大型项目math::add(2, 3)、math::PI -
using 声明（单个引入）：只引入你需要的符号，安全可控
using math::add;→ 后续可直接写add(2, 3) -
using 指令（整个命名空间）：危险！尤其在全局作用域或头文件中
using namespace math;→ 所有math内容都进入当前作用域，可能引发隐藏冲突
注意：using namespace std; 在教学代码里常见，但在实际工程中应避免，尤其不能出现在头文件中。
立即学习“C++免费学习笔记（深入）”；
匿名命名空间 vs static 全局变量
两者都限制符号链接性（internal linkage），但语义和用法不同：
namespace {
int helper = 42; // 仅本 .cpp 文件可见
void local_func() { /* ... */ }
}
// 等价于（C++11 前常用）：
static int helper = 42;
static void local_func() { / ... / }
- 匿名命名空间更现代、更一致（可包含类型、模板、嵌套命名空间）
-
static修饰变量/函数时仅对全局/命名空间作用域有效；对局部变量加static是另一回事（生命周期延长） - 类内
static成员不属于匿名命名空间，它有外部链接（需在 .cpp 中定义）
最容易被忽略的是：命名空间本身不生成任何运行时开销，也不影响二进制布局；它的全部意义都在编译期——帮你组织名字、让链接器少报 multiple definition 错误。一旦写错嵌套或漏掉 ::，错误信息往往指向调用点而非定义点，排查时得逆着作用域链往回找。
