Namespace 必须在全局或嵌套命名空间中声明，不可在函数、类或语句块内；头文件中禁用 using 和匿名 namespace，.cpp 中可谨慎使用 using；c++17 支持 namespace a::b::c 扁平定义，但前置声明仍需嵌套块；推荐用匿名 namespace 替代 Static。
namespace 声明和定义写在哪？
命名空间不是函数也不是类，它只是个作用域容器，必须在全局作用域或嵌套命名空间里声明。不能在函数内部、class 定义体里、甚至 if 块中写 namespace —— 编译器直接报错：Error: namespace definition not allowed here。
常见错误是把命名空间当成“可执行结构”，比如在 main() 里试图定义一个 namespace；正确做法是把它放在所有函数之外，通常在头文件顶部或源文件开头。
- 头文件（如
utils.h）里用namespace utils { ... }包裹声明 - 对应实现文件（如
utils.cpp）里用同名namespace utils { ... }补充定义 - 若要跨多个文件扩展同一命名空间，直接重复写同名
namespace即可，C++ 允许分段定义
using namespace std; 到底能不能用？
能用，但只该出现在 .cpp 文件最底部（且仅限非头文件），绝不能写在头文件里。否则会污染包含该头的所有翻译单元，引发符号冲突——比如你定义了 vector，而 std::vector 已存在，编译器可能无法分辨。
更安全的做法是按需引入：using std::String; 或直接写全限定名 std::cout。大型项目中，连 using std::string 都常被禁用，因为头文件一旦被广泛包含，风险就不可控。
立即学习“C++免费学习笔记（深入）”；
- 头文件里禁止任何
using指令（包括using namespace和using xxx） - .cpp 文件中，如果用了大量
std::前缀，可考虑在函数内局部使用using std::swap;等窄范围引入 -
using namespace std;放在#include后、函数前，是很多初学者误以为“安全”的位置，其实依然危险
嵌套 namespace 怎么写才不晕？
C++17 起支持 namespace A::B::C { ... } 这种扁平写法，比老式层层嵌套（namespace A { namespace B { namespace C { ... } } }）清晰得多。但要注意：这种简写只适用于定义，不适用于声明别名或前置声明。
比如你想在头文件里提前告诉编译器 A::B::C::Logger 存在，仍得写 namespace A { namespace B { namespace C { class Logger; } } }，不能用简写形式做前置声明。
- 定义时优先用
namespace foo::bar { void func(); } - 前置声明、特化模板、友元声明等场景，必须还原为嵌套块结构
- 别名写法
namespace fs = std::Filesystem;是安全的，但仅限于单层别名，不支持namespace io::fs = std::filesystem;
匿名 namespace 和 static 有什么区别？
两者都限制链接性（internal linkage），但语义不同：匿名 namespace 中的内容具有**文件作用域**且**不可被外部访问**，而 static 只对变量/函数有效，对类型无效（C++11 起 static 不能修饰 class）。更重要的是，匿名 namespace 中的 inline 变量或模板仍可跨 TU 实例化，static 变量则完全隔离。
现代 C++ 推荐用匿名 namespace 替代 static，尤其当你要放一个 class 或 constexpr 变量时，static 根本不合法。
- 函数内不能用匿名
namespace，但可以用static局部变量 - 匿名
namespace里的inline const int x = 42;在多个 .cpp 中不会违反 ODR；static const int x = 42;则每个 TU 各有一份副本 - 头文件里绝对不要写匿名
namespace，否则每个包含它的 .cpp 都会生成一份独立副本，可能导致模板实例化爆炸
事情说清了就结束。真正容易被忽略的，是头文件里混入任何 using 或匿名 namespace —— 看似无害，实则会在不知不觉中让整个项目的符号可见性失控。