c# 枚举 enum 的用法

来源：这里教程网时间：2026-02-21 17:36:20 作者：

怎么定义一个实用又安全的 enum

直接用

enum

关键字就能定义，但关键在“底层类型”和“值分配”是否合理。默认是

int

，从 0 开始递增，看似省事，但容易埋坑——比如你后续想加新项插在中间，所有后续值都会偏移。

显式赋值更可控：
enum HttpStatusCode { OK = 200, BadRequest = 400, NotFound = 404 }
小范围取值（如状态码 0–255）优先选
byte
：节省内存，且编译器会强制检查越界 ——
enum Status : byte { Idle = 0, Running = 1, Error = 255 }
避免跳着赋值（如
A = 1, B = 100, C = 101
），除非真有语义需求；否则别人读代码时容易误判连续性

字符串 ↔ 枚举转换时最常踩的三个坑

ToString()

和

Enum.TryParse()

看似简单，但实际项目里 70% 的枚举解析失败都源于大小写、空格或无效输入没兜住。

ToString()
返回的是成员名，不是描述文本（比如
DayOfWeek.Monday.ToString()
→
"Monday"
，不是
"星期一"
）
Enum.TryParse("monday", out DayOfWeek d)
默认**区分大小写**，会失败；必须加
true
参数：
Enum.TryParse("monday", true, out d)
传入空字符串或 null 给
TryParse
会返回
false
，但不会抛异常；务必检查返回值，别只依赖
out
变量

[Flags] 位枚举不是“加个特性就完事”

加了

[Flags]

特性后，

ToString()

才能输出

"Read, Write"

这种组合形式，但前提是你的值必须是 2 的幂次（1, 2, 4, 8…），否则

HasFlag()

行为不可靠。

[Flags]
public enum Permissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Execute = 4,
    All = Read | Write | Execute // ✅ 正确组合
}
Permissions p = Permissions.Read | Permissions.Write;
Console.WriteLine(p.ToString()); // 输出: "Read, Write"
Console.WriteLine(p.HasFlag(Permissions.Write)); // true

错误示范：
Read = 1, Write = 3
——
3
不是 2 的幂，
HasFlag
可能误判检查权限推荐用
(p & Permissions.Write) == Permissions.Write
，比
HasFlag
更明确、性能略高
None = 0
必须存在，且不能和其他值做按位或（否则逻辑混乱）

为什么 enum 不该出现在 public API 的 JSON 序列化里

ASP.NET Core 默认把

enum

序列化成整数（如

{ "status": 1 }

），前端根本看不懂；而设成字符串（

JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter())

）又可能破坏老客户端兼容性。

对外暴露的 API，建议用
string
字段 + 数据验证，或封装一层 DTO 映射到语义清晰的字符串（如
"active"
,
"pending"
） 内部模块间传递可用 enum，但跨服务/跨语言场景，整数序列化风险高（不同语言 enum 值可能不一致） 如果坚持用 enum 序列化，务必在 Swagger 或 OpenAPI 文档中用
[EnumMember]
显式标注每个值的字符串表示，否则文档和实际行为对不上枚举本身很简单，但真正难的是在团队协作、长期迭代、跨系统交互中保持它的语义稳定性和可解释性。很多人只记得“用名字代替数字”，却忘了名字一旦发布，改起来比数据库字段还麻烦。