必须使用 enum class 配合 uint32_t 显式底层类型定义权限位，避免裸 int 或默认 enum 导致跨平台位宽不一致、符号扩展等问题。
权限位定义必须用 enum class 配合 uint32_t 显式底层类型
直接用裸 int 或默认 enum 定义权限位，容易在跨平台或不同编译器下出现位宽不一致、符号扩展等问题。比如 enum { READ = 1 在某些旧编译器里可能被当成 <code>signed int，导致高位掩码（如第31位）触发负数行为，后续 & 判断失效。
正确做法是强制指定无符号整型底层数值类型：
enum class Permission : uint32_t {
NONE = 0,
READ = 1U << 0,
WRITE = 1U << 1,
DELETE = 1U << 2,
EXECUTE = 1U << 3,
ADMIN = 1U << 31 // 明确使用 31 而非 32，避免左移越界
};
-
1U后缀确保字面量是无符号型，防止1 << 31在有符号整型上溢出为负 - 最大位建议控制在
31（uint32_t）或63（uint64_t），避开符号位 - 不要用
std::bitset替代——它不可直接用于按位逻辑运算上下文，且无法作为函数参数高效传递
检查权限时别直接写 if (perm & Permission::READ)
这个写法看似简洁，但存在隐式转换风险：C++ 标准规定 enum class 不会自动转为整数，所以该表达式实际编译不过（除非你加了 static_cast<uint32_t>）。更隐蔽的问题是，如果某处误用了普通 enum，而后期改成 enum class，这类判断会静默失效。
推荐封装成内联函数，既安全又自解释：
立即学习“C++免费学习笔记（深入）”；
inline bool has_permission(uint32_t current, Permission p) {
return (current & static_cast<uint32_t>(p)) != 0;
}
// 使用
uint32_t user_perms = static_cast<uint32_t>(Permission::READ) |
static_cast<uint32_t>(Permission::WRITE);
if (has_permission(user_perms, Permission::EXECUTE)) { ... }
- 所有位运算操作统一在
uint32_t层面进行，不依赖枚举隐式行为 - 函数名比裸位运算更易读，也方便未来加日志或审计钩子
- 禁止把
Permission当整数传参——必须显式转，避免误传非法值（如999）
组合权限要防重复赋值和清零遗漏
常见错误是用 |= 累加权限却不校验是否已存在，或者用 &= ~ 撤销时漏掉括号，导致优先级错误：
// ❌ 错误：~Permission::READ 先转成 int 再取反，结果不是预期掩码
user_perms &= ~Permission::READ; // 编译失败或行为未定义
// ✅ 正确：先转整型，再取反，再与
user_perms &= ~static_cast<uint32_t>(Permission::READ);
// ✅ 更稳妥的撤销函数
inline void revoke_permission(uint32_t& current, Permission p) {
current &= ~static_cast<uint32_t>(p);
}
- 增删权限必须成对封装，避免裸运算散落在业务逻辑中
- 初始化用户权限时，别依赖全局默认值——显式设为
static_cast<uint32_t>(Permission::NONE)</uint32_t> - 数据库存权限字段时，务必用
UINT32类型，而非INT；MySQL 的INT默认有符号，第31位会被解释为负数
调试时打印权限别手写二进制字符串
人工数 32 位太容易出错，尤其当权限值来自数据库或网络序列化后。用 std::bitset<32> 辅助诊断最直接：
void debug_permissions(uint32_t perms) {
std::bitset<32> bs(perms);
std::cout << "Raw: 0x" << std::hex << perms
<< " | Bits: " << bs.to_string() << "\n";
// 输出示例：Raw: 0x9 | Bits: 00000000000000000000000000001001
}
-
std::bitset只用于调试/日志，不参与运行时权限判断逻辑 - 线上环境建议关掉这类输出，避免字符串构造开销
- 如果权限集超过 32 位（比如要支持插件动态扩展），就得切分到多个
uint32_t字段，并设计索引映射，不能硬扩到uint64_t就完事——很多旧系统仍按 32 位对齐处理
