命名空间必须在全局作用域、类作用域或另一命名空间内定义，不可在函数内部声明；using声明仅导入单个名称，安全可控，而using指令导入整个命名空间，易引发冲突，头文件中严禁使用。
命名空间声明和定义要写在全局作用域里
如果把 namespace 声明写在函数内部，编译器会直接报错：error: namespace definition not allowed here。命名空间只能出现在全局作用域、类作用域（作为嵌套命名空间）或另一个命名空间内部。
常见误写：
void foo() {
namespace ns { int x = 42; } // ❌ 错误：不能在函数内定义命名空间
}
正确方式是提出来：
namespace ns {
int x = 42;
void bar() { /* ... */ }
}
using声明和using指令的区别很关键
using 声明（如 using std::vector）只导入单个名字，安全可控；using 指令（如 using namespace std）会把整个命名空间所有名字都拉进来，极易引发名称冲突，尤其在头文件中绝对禁止。
- 在源文件（.cpp）顶部偶尔用
using namespace std可以省点键入，但仅限于小项目或练习 - 在头文件中写
using namespace是严重错误，会导致包含该头文件的所有翻译单元污染全局命名空间 - 更稳妥的做法是显式写出
std::vector、std::string，或者用using std::swap;这类精准导入
匿名命名空间替代static关键字
C++ 中文件作用域的 static 函数或变量，推荐改用匿名命名空间——语义更清晰，且能包含类型定义：
namespace {
const int MAX_RETRY = 3;
class Helper { /* ... */ };
void local_util() { /* ... */ }
}
它等价于 static 的链接属性（internal linkage），但支持更多语法；注意不要在头文件里定义匿名命名空间，否则每个包含它的 .cpp 都会生成一份副本，可能违反 ODR（One Definition Rule）。
嵌套命名空间要避免重复缩进和冗长别名
C++11 支持连续嵌套写法：namespace A { namespace B { namespace C { ... } } }，但更简洁的是 namespace A::B::C。不过要注意：这种简写只适用于定义，不适用于前置声明。
当嵌套过深（比如 mylib::v2::detail::impl），频繁书写很累，可用 namespace impl = mylib::v2::detail::impl; 创建别名。但别名本身也应控制粒度——别把整个长路径都 alias 成 ns，那样反而失去可读性。
容易被忽略的一点：嵌套命名空间中的名字查找遵循“就近原则”，外层同名符号不会自动遮蔽内层，但内层未定义的符号会向外逐层查找（ADL 机制另说）。调试时若发现意外调用了外层函数，先检查是否少写了内层实现，而非假设命名空间隔离失效。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
