必须用 enum class 配合 uint32_t 显式底类型定义权限位，避免裸 int 或 enum 因编译器默认底层类型不一致导致跨平台序列化或网络传输错误。
权限位定义必须用 enum class 配合 uint32_t 显式底类型
直接用裸 int 或 enum 定义权限位，容易因编译器默认底层类型不一致导致跨平台行为差异，尤其在结构体序列化或网络传输时出错。比如 enum Permission { Read = 1, Write = 2 } 在某些平台可能被当作 char 处理，Write 就会溢出或截断。
正确做法是强制指定为无符号 32 位整数，并用作用域枚举避免隐式转换：
enum class Permission : uint32_t {
None = 0,
Read = 1U << 0,
Write = 1U << 1,
Execute = 1U << 2,
Delete = 1U << 3,
Admin = 1U << 31 // 最高位留作超级权限，避免与常规位混淆
};
-
1U确保字面量是无符号型，防止左移后符号扩展 - 所有值用
U后缀，避免有符号整数溢出警告（如 MSVC 的 C4307） - 不要跳着定义位（比如
Read = 1, Write = 4），否则static_cast<uint32_t>(Read | Write)可能产生非预期的中间值
PermissionSet 类必须重载 |、&、~ 和 ==
权限集合不是简单整数，而是语义明确的组合类型。若只用 uint32_t 存储，调用方极易写出 if (perm & 5) 这类无法维护的硬编码逻辑。
封装成类后，运算符重载让意图清晰且类型安全：
立即学习“C++免费学习笔记（深入）”；
class PermissionSet {
uint32_t bits_ = 0;
public:
PermissionSet() = default;
explicit PermissionSet(Permission p) : bits_(static_cast<uint32_t>(p)) {}
PermissionSet operator|(Permission p) const {
return PermissionSet{bits_ | static_cast<uint32_t>(p)};
}
PermissionSet operator&(Permission p) const {
return PermissionSet{bits_ & static_cast<uint32_t>(p)};
}
PermissionSet operator~() const {
return PermissionSet{~bits_};
}
bool operator==(const PermissionSet& other) const { return bits_ == other.bits_; }
bool has(Permission p) const {
return (bits_ & static_cast<uint32_t>(p)) != 0;
}
};
-
has()是唯一暴露的查询接口，禁止外部直接访问bits_ - 重载
==而非bool operator，避免if (perms)这种模糊判断 - 不提供
+=或-=，权限增减应显式用|=/&= ~p，降低误操作概率
检查权限时别用 if (perms & Permission::Read) 直接判布尔
这是最常见也最危险的习惯——Permission::Read 值为 1，perms & Read 结果是 1 或 0，看似能当布尔用。但一旦权限位定义成 Admin = 1U << 31，在 32 位系统上该表达式结果是 0x80000000，强转 bool 虽然仍为 true，但若后续有人加了 if (perms & Admin > 0) 就会出错（因为有符号比较）。
- 永远用
perms.has(Permission::Read)，语义明确且屏蔽底层细节 - 若必须用位运算（如性能敏感内循环），写成
(perms.bits_ & static_cast<uint32_t>(Permission::Read)) != 0 - 禁用
static_cast<bool>(perms.bits_ & ...)：MSVC 和 GCC 对高位掩码的布尔转换行为一致，但可读性差、易被误改
序列化到 JSON 或数据库时，务必转成小写字符串数组而非数字
把 PermissionSet{Read | Write} 直接存成 3 或十六进制 "0x3"，等于放弃可读性和向前兼容性。一旦新增权限位（比如插在中间），旧数据解析就会错乱；调试日志里看到 137 根本不知道对应哪些权限。
推荐方案：导出为字符串数组，按位定义顺序排列（非数值大小）：
// 示例：PermissionSet{Read | Delete | Admin} → ["read", "delete", "admin"]
std::vector<std::string> toVector() const {
std::vector<std::string> out;
if (has(Permission::Read)) out.push_back("read");
if (has(Permission::Write)) out.push_back("write");
if (has(Permission::Execute))out.push_back("execute");
if (has(Permission::Delete)) out.push_back("delete");
if (has(Permission::Admin)) out.push_back("admin");
return out;
}
- 不依赖
std::to_string(bits_)，那是给机器看的，不是给人看的 - 反序列化时严格校验字符串是否在预设白名单内，非法项直接拒绝，不静默忽略
- 数据库字段类型用
TEXT或JSON，别用INT—— 权限本质是集合，不是数量
Permission::Audit 加入后，所有旧用户默认不该拥有它，但管理员组需要自动继承。这种逻辑没法靠位运算自动推导，得在业务层显式控制。位掩码只是容器，不是策略。 
