C++ 内联命名空间（Inline Namespace）怎么实现多版本 API 平滑过渡-C++-PHP中文网

内联命名空间的核心作用是将内联子空间中的名称自动提升至外层命名空间作用域，使旧代码无需修改调用形式（如仍写mylib::process()）即可绑定到新版本实现；正确做法是让版本命名空间本身标记为inline，而非在其内部再嵌套inline。

c++ 内联命名空间（inline namespace）怎么实现多版本 api 平滑过渡

内联命名空间如何让旧代码自动迁移到新版本

内联命名空间的核心作用不是“定义多个版本”，而是让嵌套在其中的名称**自动提升到外层命名空间作用域**。这意味着：只要把新版本 API 放进 inline namespace，老代码调用时无需改名、不加前缀，就能直接使用新实现。

常见错误是把它当普通命名空间用——比如写 namespace v2 { inline namespace impl { ... } }，结果调用时还得写 v2::impl::func()，这就完全失去意义了。

正确做法是让版本命名空间本身标记为 inline：

namespace mylib {
  inline namespace v1 {
    void process(int x) { /* v1 实现 */ }
  }
}

此时 mylib::process(42) 直接解析到 v1::process。后续升级时，只需把 v1 改成 v2 并标记为 inline，同时保留旧版为非内联：

namespace mylib {
  namespace v1 {
    void process(int x) { /* 旧实现，仍可显式调用 */ }
  }
  inline namespace v2 {
    void process(int x) { /* 新实现，成为默认行为 */ }
  }
}

头文件里怎么组织多版本符号不冲突

关键在于：所有版本声明必须出现在同一头文件中，且每个符号在任意时刻只能有一个 inline 版本被激活。编译器按“最内层 inline 命名空间”决定默认绑定。

容易踩的坑：

在不同头文件中分别定义 inline namespace v1 和 inline namespace v2，会导致 ODR 违反（同一个符号有多个 inline 定义）
忘记把旧版移出 inline 状态，造成两个 inline 版本共存，编译器报错 error: inline namespace 'v1' and 'v2' cannot both be inline in the same scope
模板特化没同步更新到新 inline 命名空间，导致特化失效（特化必须和主模板在同一 inline 层级）

推荐结构：

namespace mylib {
  // v1 保持可用但不 inline
  namespace v1 {
    struct Config { int timeout; };
    void init(const Config&);
  }
<p>// v2 是当前默认
inline namespace v2 {
struct Config { int timeout_ms; std::string log_level; };
void init(const Config&);
}
}</p>