C++中如何将enum class枚举值解析为对应名称字符串实现流输出

截至C23，标准C没有内置的枚举标识符存储机制，不存在你期望的原生name()接口。
C++遵循零开销原则，编译阶段默认会丢弃枚举项的标识符文本，不会把这些字符串信息编入二进制，所以你没法直接从一个枚举值拿到对应的名称字符串。你现在手写switch的写法是最朴素、零依赖、性能最高的实现，boost的相关实现也不是靠什么语言内置的枚举名存储，本质是通过模板元编程、宏或者编译器特性在编译期生成了映射关系。 #

下面两种方案都不需要引入第三方库，可以根据你的项目C++版本和需求选择：

方案1：X宏映射（全C++版本兼容，无编译器依赖） #

这是从C时代沿用至今的稳定方案，只需要在定义枚举时统一维护枚举项列表，就能自动生成枚举定义、字符串转换、流重载逻辑，不需要手动写每一个switch分支，编译后代码和你手写switch完全等价，零额外开销。
示例代码：

// 统一维护所有枚举项，需要新增枚举项只改这里就行
#define TEST_ENUM_ITEMS \
    X(None, 0) \
    X(Foo) \
    X(Bar)

// 自动生成enum class定义
enum class TestEnum
{
    #define X(name, val) name = val,
    #define X(name) name,
    TEST_ENUM_ITEMS
    #undef X
};

// 自动生成<<运算符重载
std::ostream& operator<<(std::ostream& os, TestEnum e)
{
    switch(e)
    {
        #define X(name, val) case TestEnum::name: return os << #name;
        #define X(name) case TestEnum::name: return os << #name;
        TEST_ENUM_ITEMS
        #undef X
        default: return os << "Unknown(" << static_cast<int>(e) << ")";
    }
}

如果要做通用模板，只需要给每个枚举维护对应的ITEM宏列表，就能批量生成所有转换逻辑，适合项目里枚举多、需要长期维护的场景。

方案2：编译器内置宏实现无侵入反射（C++17及以上，无需修改现有枚举定义） #

如果你不想改动已经写好的枚举定义，可以利用主流编译器自带的编译期宏：GCC/Clang下的__PRETTY_FUNCTION__、MSVC下的__FUNCSIG__。这两个宏会在编译时把当前模板实例化的枚举值信息以字符串形式嵌入，你可以通过简单的字符串截取在编译期拿到枚举项名称，写一次通用模板就能给所有枚举用。
最简实现示例：

#include <string_view>
#include <ostream>
#include <type_traits>

template <auto E>
constexpr std::string_view get_enum_name() noexcept
{
#if defined(__GNUC__) || defined(__clang__)
    std::string_view sv = __PRETTY_FUNCTION__;
    constexpr std::string_view prefix = "E = ";
    constexpr std::string_view suffix = ";";
#elif defined(_MSC_VER)
    std::string_view sv = __FUNCSIG__;
    constexpr std::string_view prefix = "E = ";
    constexpr std::string_view suffix = ">";
#endif
    auto start = sv.find(prefix) + prefix.size();
    auto end = sv.find(suffix, start);
    sv = sv.substr(start, end - start);
    // 去掉枚举类型前缀，比如TestEnum::Foo只保留Foo
    if (auto pos = sv.find("::"); pos != std::string_view::npos)
        sv = sv.substr(pos + 2);
    return sv;
}

// 给所有枚举类型通用的<<重载
template <typename T, typename = std::enable_if_t<std::is_enum_v<T>>>
std::ostream& operator<<(std::ostream& os, T e)
{
    return os << get_enum_name<static_cast<T>(static_cast<std::underlying_type_t<T>>(e))>();
}

这个方案是无侵入的，你原来的TestEnum定义不需要做任何修改就能直接用std::cout << TestEnum::Foo输出Foo，所有字符串处理都是编译期完成的，运行时没有任何额外开销。注意这个方案依赖编译器的宏输出格式，GCC5+、Clang3.5+、MSVC2017+都能正常工作，唯一限制是枚举值范围不能太大（一般默认支持-128~127范围的枚举值，足够绝大多数业务场景使用）。 #

你可能听过的magic_enum库本质上就是第二种方案的工程化封装，如果不想引入第三方库，上面的精简实现足够应付日常开发。另外C++26已经确定加入静态反射特性，届时可以直接通过标准接口获取枚举名称，不需要这些黑魔法，但目前主流编译器还未完整支持该特性。

内容的提问来源于stack exchange，提问作者tenslw