内联命名空间通过inline关键字声明，核心作用是自动注入——使子命名空间成员可被父命名空间直接访问；与普通命名空间不同，它参与adl和using查找，且影响名字查找规则而非符号修饰。
内联命名空间怎么声明，和普通命名空间差在哪
内联命名空间的核心作用是“自动注入”，它让子命名空间里的名字像定义在父命名空间里一样可直接使用。不是语法糖，而是标准规定的查找规则调整。
声明时只多一个 inline 关键字：
namespace v1 {
inline namespace abi_v1 {
struct Config { int version = 1; };
void load();
}
}关键区别在于：调用 load() 时，不需要写 v1::abi_v1::load()，v1::load() 就能匹配成功——编译器会自动在 v1 的所有内联子空间里找。
- 普通命名空间（无
inline）不会参与 ADL 或 using 查找，必须显式限定 - 一个命名空间里可以有多个内联命名空间，但只能有一个“当前活跃”的（通常最新版），否则会引发 ODR 冲突
- 内联命名空间可以嵌套，但不建议超过一层，否则符号导出和调试信息会变混乱
用内联命名空间做 ABI 版本管理，实际怎么切版本
本质是把不同 ABI 兼容层包装进不同的内联命名空间，再通过宏控制哪个被标记为 inline，从而让头文件接口不变，而链接时绑定到具体实现。
立即学习“C++免费学习笔记（深入）”；
典型做法：
#ifdef USE_ABI_V2
namespace v2 {
inline namespace abi_v2 {
struct Config { int version = 2; std::string path; };
void load();
}
}
#else
namespace v2 {
inline namespace abi_v1 {
struct Config { int version = 1; };
void load();
}
}
#endif- 用户代码始终写
v2::Config和v2::load()，不用改源码 - 库作者发布新版时，只需改宏定义、新增内联命名空间块，旧对象文件仍可链接（只要符号名没变）
-
libfoo.so.1和libfoo.so.2可以共存，因为内联命名空间不影响符号修饰（_Z3loadv23abi_v16Config这类名字依然带完整路径）
为什么 using namespace 在内联命名空间里要特别小心
内联命名空间会让 using namespace X 的行为变得隐晦——它不仅导入 X 本身的内容，还会把 X 里所有内联子空间的内容一并拉进来，且无法单独屏蔽。
比如：
namespace v3 {
inline namespace abi_v3_0 {
void init();
}
inline namespace abi_v3_1 {
void init(); // 重载，但不是函数模板特化！
void cleanup();
}
}此时 using namespace v3; 会导致两个 init() 都可见，调用时若参数不明确，编译器可能报 call to 'init' is ambiguous。
- 避免在头文件中对含内联命名空间的范围做
using namespace - 如果必须用，优先用
using v3::init;显式引入特定符号 - 动态库导出时，
__attribute__((visibility("default")))要打在具体函数上，不能依赖using带来的可见性
链接时报 undefined reference to 'v2::load()' 是哪里错了
最常见原因是：头文件里声明了内联命名空间，但实现文件里定义时没写全路径，或者没加 inline。
错误示范：
// header.h
namespace v2 {
inline namespace abi_v1 {
void load();
}
}
<p>// impl.cpp —— 缺少 inline，编译器认为这是另一个非内联空间
namespace v2 {
namespace abi_v1 { // ❌ 这里不是 inline
void load() { /<em> ... </em>/ }
}
}结果：链接器看到声明是 v2::abi_v1::load（因内联而等价于 v2::load），但定义生成的符号却是 v2::abi_v1::load（非内联语义下不等价），于是找不到。
- 实现文件中定义必须严格匹配声明：包括
inline关键字和嵌套层级 - 用
nm -C libfoo.a | grep load检查实际导出的符号名，确认是否含abi_v1或abi_v2 - GCC 12+ 和 Clang 14+ 支持
[[gnu::visibility("default")]]直接标在内联命名空间块上，但需确保整个块都一致
内联命名空间不是魔法，它改变的是名字查找规则，而不是符号生成逻辑。漏掉 inline、头/实现不一致、或跨编译单元混用不同 ABI 宏，都会让链接器一头雾水。
