遇到 Rust 宏展开报错 no rules expected the token，通常是因为宏调用时的 token 序列不匹配任何定义的规则臂。最推荐的处理方向是检查宏定义中的片段说明符是否与调用参数类型一致，并使用 cargo expand 查看展开结果。风险边界在于修改宏定义可能影响其他调用点，需回归测试。
先说结论：该错误表明宏调用输入未匹配任何宏规则臂，需修正片段说明符或调用语法。
- 先确认：宏调用处的 token 序列是否与定义臂中的模式一致
- 先处理：使用 cargo expand 工具查看宏展开后的具体代码形态
- 再验证：执行 cargo build 确认编译通过且无回归错误
命令速用版
cargo install cargo-expand
cargo expand <crate_name>::<macro_name>为什么会这样
Rust 宏系统基于模式匹配，编译器在编译期尝试将输入 token 与宏定义中的规则臂逐一比对。如果所有规则臂都无法匹配当前输入的 token 序列，编译器就会抛出 no rules expected the token 错误。这通常涉及片段说明符（如 :expr, :ident）类型不匹配或分隔符（如逗号、分号）缺失。
分步处理
1. 定位报错位置：查看编译器输出的错误行号，确认是宏调用处还是宏定义处报错。
2. 检查片段说明符：对比宏定义中的 $var:fragment 与调用处传入的实际类型。例如，传入字面量时不能用 :ident。
3. 使用展开工具：运行 cargo expand 查看宏展开后的代码，确认解析器在哪一步停止匹配。
4. 调整规则臂：如果需要匹配多种类型，考虑增加规则臂或使用更通用的 :tt（token tree），但需注意 :tt 可能掩盖类型错误。
5. 检查分隔符：确认宏定义中要求的逗号、分号或括号在调用处是否完整存在。
怎么验证是否生效
执行 cargo build 或 cargo check，确认不再出现 no rules expected the token 错误。同时观察 cargo expand 输出，确认宏已展开为预期的 Rust 代码结构。
常见坑
1. 滥用 :tt：虽然 :tt 能匹配几乎所有 token，但会失去类型检查能力，导致后续代码报错更难调试。
2. 忽略重复分隔符：宏定义中使用 $(...),* 时，调用处多余或缺少的逗号都会导致匹配失败。
3. 递归限制：宏内部递归调用过深可能触发 recursion limit 错误，虽不同于 token 错误，但常伴随出现。
常见问题
fragment specifier 有哪些常用类型？
常用类型包括 :item、:block、:stmt、:expr、:pat、:ty、:ident、:tt、:lifetime、:meta。不同类型匹配不同的语法结构，混用会导致匹配失败。
cargo expand 看不到宏展开内容怎么办？
确保已安装 cargo-expand 且版本与 toolchain 兼容，部分过程宏需要特定配置才能查看展开，声明宏通常可直接查看。
参考来源
- The Rust Reference - Macros, https://doc.rust-lang.org/reference/macros.html
- cargo-expand - GitHub, https://github.com/dtolnay/cargo-expand