inline namespace 是 C++11 引入的用于库版本控制与 ABI 稳定的机制，使不同版本符号共存并默认使用最新 inline 版本，无需用户显式指定；其本质是链接器可见的 ABI 分隔，非性能优化手段。
inline namespace 是 C++11 引入的特性，核心用途是实现**库的向后兼容版本控制**，让不同版本的符号能共存且自动选择最新版，而无需用户显式指定版本名。它不是用来优化性能的（和 inline 函数无关），而是为 ABI 稳定与平滑升级服务的。
inline namespace 的基本写法
在命名空间内用 inline 关键字声明一个嵌套命名空间，该命名空间中的名字会“提升”到外层命名空间作用域中：
namespace MyLib {
inline namespace v2 {
void func(); // ✅ 可直接通过 MyLib::func() 调用
class Widget { /*...*/ };
}
namespace v1 {
void func(); // ❌ 不会自动暴露，需 MyLib::v1::func()
}
}
此时 MyLib::func() 默认解析为 v2::func()；v1::func() 仍存在，但不参与重载或 ADL 的默认查找（除非显式限定）。
版本升级时保持 ABI 兼容
当发布新版本（如 v3），只需新增 inline namespace v3，并把旧 inline 去掉：
立即学习“C++免费学习笔记（深入）”；
- 原 v2 是 inline → 用户代码调用
MyLib::func()绑定到 v2 - 升级后改为
inline namespace v3，v2 不再 inline → 新编译的代码自动用 v3，老二进制仍链接 v2 符号（只要 v2 保留定义） - v1、v2 的实现必须保留在库中（不能删），确保旧程序运行不崩溃
配合头文件 + 链接控制实现“单头多版”
常见实践是用宏控制 inline 层级，让头文件适配不同构建场景：
// MyLib.hpp
#pragma once
#include <string>
namespace MyLib {
#if MYLIB_VERSION == 3
inline namespace v3 {
#elif MYLIB_VERSION == 2
inline namespace v2 {
#else
inline namespace v1 {
#endif
std::string format(int x);
void log(const std::string& s);
}
// 所有版本都保留的非 inline 接口（稳定 ABI）
void init();
}
搭配构建系统（如 CMake）设置 -DMYLIB_VERSION=3，即可切换默认行为。注意：头文件中不能出现条件编译导致 inline 状态不一致，否则 ODR 违规。
注意事项与陷阱
-
不能跨 inline namespace 重载：若 v2 和 v3 都定义了
void foo(int)，它们不是重载关系，而是重复定义（ODR error） -
ADL（参数依赖查找）只找 inline 版本：对
foo(obj)，若obj类型在v2中定义，ADL 会查v2，即使当前 using 的是v3 -
导出符号名含版本前缀：编译器通常将
MyLib::v2::func编码为类似_ZN6MyLib2v24funcEv，链接时不冲突 - 慎用于模板定义：模板声明需在 inline ns 内，但显式特化可在外层 —— 容易混乱，建议所有模板相关都放在 inline ns 中
不复杂但容易忽略：inline namespace 不是语法糖，它是链接器可见的 ABI 分隔机制。用好它，库作者就能让用户“无感升级”，同时自己守住兼容底线。
