Rust 的宏系统功能强大，能在编译时生成代码，但编写宏（尤其是过程宏）有挑战，因为 Rust 有严格的语法和类型检查，此时 Syn crate 就很有用。

• 什么是 Syn：是 Rust 源代码的解析器，主要用于创建过程宏，能解析、操作和生成 Rust 代码，提供丰富的抽象语法树（AST），与quote crate 配合良好，处理 Rust 中的许多边缘情况和复杂语法模式，降低解析错误风险。
• 设置 Syn：在Cargo.toml的依赖中添加syn和quote，如[dependencies] syn = "2.0" quote = "1.0"。

• 基本示例：编写简单宏：通过#[proc_macro_derive(FieldCounter)]定义宏，解析输入的TokenStream为DeriveInput，根据输入生成代码，如计算结构体字段数的方法。

  • 解析输入：parse_macro_input!将输入解析为DeriveInput结构。
  • AST 操作：检查输入是否为结构体并计数字段。
  • 代码生成：使用quote!生成 Rust 代码的TokenStream。
• 测试宏：通过#[derive(FieldCounter)]应用宏到结构体，然后在main函数中调用生成的方法。

• 其他示例：

  • 生成结构体的默认实现：通过#[proc_macro_derive(DefaultNew)]定义宏，为结构体生成默认的new()函数。
  • 添加自定义获取器方法：通过#[proc_macro_derive(Getters)]定义宏，为结构体生成每个字段的公共获取器方法。
  • 自定义属性宏的错误消息：通过#[proc_macro_attribute]定义宏，验证#[min_length]属性的使用，对错误使用生成编译时错误消息。
  • 自动记录函数调用：通过#[proc_macro_attribute]定义宏，在函数调用时自动记录函数名。
  • 基于字段类型实现 trait 方法：通过#[proc_macro_derive(OptionalDefaults)]定义宏，为包含Option字段的结构体实现Default trait。
  • 生成 to_json 方法：通过#[proc_macro_derive(ToJson)]定义宏，为结构体生成to_json方法，将结构体字段序列化为 JSON 字符串。
  • 生成构建器模式：通过#[proc_macro_derive(Builder)]定义宏，为结构体生成构建器模式，包括构建器结构体、设置器方法和构建方法。
• Syn 特殊之处：能解析复杂语法并生成新代码，适合框架和库，如 Diesel 用于 SQL 查询构建的编译时安全，Rocket 用于处理 Web 应用的复杂路由属性，可创建节省时间、减少错误和添加新功能的宏。
• 资源：文档Syn Crate on docs.rs、仓库GitHub - Syn Repository、crateSyn on crates.io。