1. 自定义 derive 宏: #[derive(MyTrait)]
2. 属性宏: #[my_attribute]
3. 函数式宏: my_macro!(...)

// 输入：TokenStream（Rust 代码的 token 流）
// 输出：TokenStream（要追加的代码）

// #[derive(HelloMacro)]
// struct Pancakes;

// 过程宏生成：
// impl HelloMacro for Pancakes {
//     fn hello_macro() {
//         println!("Hello, Macro! My name is Pancakes");
//     }
// }

# Cargo.toml
[lib]
proc-macro = true

[dependencies]
syn = "2"
quote = "1"
proc-macro2 = "1"

// src/lib.rs
use proc_macro::TokenStream;
use quote::quote;
use syn::{parse_macro_input, DeriveInput};

#[proc_macro_derive(HelloMacro)]
pub fn hello_macro_derive(input: TokenStream) -> TokenStream {
    let input = parse_macro_input!(input as DeriveInput);
    let name = &input.ident;

    let expanded = quote! {
        impl HelloMacro for #name {
            fn hello_macro() {
                println!("Hello, Macro! My name is {}", stringify!(#name));
            }
        }
    };

    TokenStream::from(expanded)
}

#[proc_macro_attribute]
pub fn route(attr: TokenStream, item: TokenStream) -> TokenStream {
    // attr: 宏属性参数
    // item: 被标注的函数
    item
}

#[proc_macro]
pub fn sql(input: TokenStream) -> TokenStream {
    // 解析 SQL 字符串并生成代码
    input
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[derive(Serialize, Deserialize)]  // serde
#[derive(Error)]                     // thiserror