命名空间定义的基本语法是namespace 名称 { / 成员 / }，不加分号；允许多次同名定义并自动合并，常用于头文件声明与源文件实现分离。
命名空间定义的基本语法
在 C++ 中，用 namespace 关键字加名称来定义命名空间，最简形式就是 namespace N { /* 内容 */ }。它不带分号，也不需要返回值或类型声明——这点和函数、类不同，容易误加 ; 导致编译报错 expected unqualified-id before ‘}’ token。
命名空间可以多次定义（即“续写”），所有同名定义会自动合并，所以常用来分散声明：比如头文件里放声明，源文件里放实现。
-
namespace util { void log(); }—— 头文件中只声明 namespace util { void log() { std::cout —— 源文件中定义实现- 两个定义合起来，就构成完整的
util命名空间
匿名命名空间替代 static 全局变量/函数
在 .cpp 文件顶部写 namespace { int count = 0; void helper() {} }，等价于用 static 修饰，作用域限于当前翻译单元。但比 static 更清晰、更现代，且能封装类型（static 不能修饰 class 或 alias）。
注意：匿名命名空间里的名字无法被其他文件引用，即使用了 extern 也无效；同时它不是“私有命名空间”，只是无名，不等于 private。
- 适用于工具函数、配置常量、临时类型等仅本文件需用的内容
- 不能在头文件中使用（会导致每个包含它的 .cpp 都生成一份独立副本，可能引发 ODR 违规）
- 别和内联命名空间（
inline namespace）混淆，后者用于 ABI 版本控制，不是这个用途
using 指令与 using 声明的区别和风险
using namespace std; 是最常见也最容易出问题的写法——它把整个 std 名字注入当前作用域，一旦你定义了同名标识符（比如 size()、find()），就会触发重定义或歧义错误，尤其在大型项目或头文件中极其危险。
更安全的做法是按需引入：
-
using std::vector;—— 只引入一个类型，不影响其他 -
using std::swap;—— 引入函数，支持 ADL（参数依赖查找） - 绝对避免在头文件中写
using namespace，哪怕只是using namespace detail; - 在函数内部用
using通常没问题（作用域窄），但也要看是否真有必要
嵌套命名空间与 C++17 的折叠写法
传统嵌套写法冗长：namespace A { namespace B { namespace C { ... } } }。C++17 起支持 namespace A::B::C { ... }，语义完全等价，但可读性好很多，也方便重构——改名时只需改一处路径。
不过要注意：折叠写法只能用于定义，不能用于声明已有嵌套空间中的新成员（比如 A::B::C::func() 的声明仍需先打开 A::B::C 空间）。
-
namespace mylib::net::http { class Request; }✅ 合法定义 -
void mylib::net::http::handle(Request&);❌ 编译失败，必须写进对应命名空间块内，或用作用域解析符显式限定 - 旧编译器（如 GCC
命名空间本身不占运行时开销，但名字查找深度和冲突检查会影响编译速度；真正容易被忽略的是跨文件定义一致性——比如头文件里写了 namespace X { struct S; }，而某个 .cpp 忘了用 X::S 就直接定义 struct S {}，结果定义到了全局空间，链接时找不到符号。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
