命名空间是c++中用于逻辑分组、避免命名冲突的编译期机制，不改变文件结构；需避免头文件中使用using Namespace，优先单名引入或显式限定，匿名命名空间替代Static更现代安全。
命名空间不是文件夹，是逻辑分组工具
命名空间在 C++ 里不改变文件结构或编译路径，它只在编译期起作用，用来把同名的 class、function、variable 隔离开。比如你写了两个 Logger 类，一个用于网络模块，一个用于日志归档，不加命名空间，编译器直接报错：「redefinition of Logger」。
常见错误现象：Error: redefinition of 'XXX' 或链接时出现 undefined reference to 'XXX'（其实是用了错误命名空间下的符号）。
- 命名空间不能嵌套声明两次同名顶层块：
namespace A { int x; }和后面再写一遍namespace A { void f(); }是合法的，但写成namespace A { namespace A { ... } }就不行 - 全局命名空间（即没写
namespace的代码）和::func()是一回事，::显式表示“从全局找” - 头文件里**不要**用
using namespace std;—— 它会把整个std暴露进包含该头的所有源文件，污染别人的名字
using 声明和 using 指令的区别很关键
using std::vector; 是声明，只导入一个名字；using namespace std; 是指令，把整个命名空间拉进来。后者在头文件里等于埋雷，在 .cpp 文件里也建议只在函数内部、小范围使用。
典型踩坑场景：你写了 using namespace std;，然后定义了 std::String 同名的 string 变量，或者自己实现了一个 find()，结果调用时编译器选错了重载版本。
立即学习“C++免费学习笔记（深入）”；
- 优先用
using std::swap;这类单名引入，尤其在模板中需要 ADL（参数依赖查找）时 - 在函数体内用
using namespace boost::asio;有时可读性更好，但别放在头文件或全局作用域 -
std::前缀虽然啰嗦，但最安全——现代编辑器补全快，敲std::v就能出std::vector
匿名命名空间替代 static，且更现代
过去用 static 限定函数/变量只在本文件可见，C++11 起推荐用匿名命名空间，语义更清晰，且能包裹类型定义（static 不能修饰 class）。
示例：
namespace { Struct Config { int timeout; }; Config load_config(); } 这个 Config 类型和 load_config 函数都只在当前编译单元内有效。
- 匿名命名空间等价于一个唯一名称的命名空间（如
namespace __unique_123 {...}），由编译器保证不冲突 - 不能在头文件里写匿名命名空间——每个包含它的 .cpp 都会生成一份独立副本，看似“内部链接”，实则浪费符号和内存
- 如果只是想隐藏辅助函数，匿名命名空间比
static更一致：统一用命名空间管理作用域
跨文件使用时，别漏掉命名空间闭合和前置声明
定义在命名空间里的类，如果要在另一个文件里做前置声明，必须带上完整路径。比如 A::B::C 类，在别的文件里不能只写 class C;，得写 namespace A { namespace B { class C; } } 或 C++17 的内联写法 namespace A::B { class C; }。
容易忽略的点：命名空间可以跨多个文件定义，但必须完全匹配大小写和嵌套层级。少一个 inline（C++17 内联命名空间）、多一层括号、拼错名字，都会导致符号找不到。
- 头文件中定义命名空间，结尾别漏
}—— 很多人复制粘贴后删多了，导致后续所有声明都被包进命名空间 - 嵌套命名空间建议用 C++17 的折叠写法：
namespace A::B::C { ... }，比三层大括号易读且不易错行 - 模板特化必须在原命名空间里做，不能在全局或别的命名空间里写
template struct std::hash<mytype> {...}</mytype>—— 必须在std里，而标准禁止用户往std里加东西，所以实际要用namespace std特化（有限制条件）
命名空间本身不耗运行时资源，但设计不当会让符号查找变慢、链接失败、模板实例化爆炸——关键是别把它当“目录”来组织代码，而是当作“契约”：谁负责提供哪些名字，谁承诺不碰别人的地盘。