入门proc macros遇阻：测试代码运行报错求解答

问题背景 #

参考文章《Can a procedural macro be debugged as a function?》入门过程宏，编写测试代码在Playground运行时出现类型不匹配错误，尝试类型转换无效，需解决该问题以推动团队从C/C++转向嵌入式Rust开发。

测试代码：

extern crate proc_macro;
use proc_macro2::TokenStream;
use std::str::FromStr;
use syn;
use quote;

fn main() {
    let ts = TokenStream::from_str("fn foo() {}").unwrap();
    let _ts_str = ts.to_string();
    let parsed = syn::parse_macro_input!(ts);
}

报错信息：

error[E0308]: mismatched types
   --> src/main.rs:10:18
    |
10  |     let parsed = syn::parse_macro_input!(ts);
    |                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^
    |                  |
    |                  expected struct `proc_macro::TokenStream`, found struct `TokenStream2`
    |                  arguments to this function are incorrect
    |
note: function defined here
   --> /playground/.cargo/registry/src/github.com-1ecc6299db9ec823/syn-1.0.103/src/parse_macro_input.rs:138:8
    |
138 | pub fn parse<T: ParseMacroInput>(token_stream: TokenStream) -> Result<T> {
    |        ^^^^^
    = note: this error originates in the macro `$crate::parse_macro_input` which comes from the expansion of the macro `syn::parse_macro_input` (in Nightly builds, run with -Z macro-backtrace for more info)

error[E0308]: mismatched types
  --> src/main.rs:10:18
   |
10 |     let parsed = syn::parse_macro_input!(ts);
    |                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^ expected `()`, found struct `proc_macro::TokenStream`
    |
    = note: this error originates in the macro `$crate::parse_macro_input` which comes from the expansion of the macro `syn::parse_macro_input` (in Nightly builds, run with -Z macro-backtrace for more info)

错误原因分析 #

1. TokenStream类型不匹配：syn::parse_macro_input!宏是专门为过程宏入口函数设计的，它接收的是proc_macro::TokenStream（标准库提供的过程宏专用TokenStream），但代码中使用的是proc_macro2::TokenStream（第三方库提供的可在普通代码中使用的TokenStream，报错中显示为TokenStream2），两者类型不兼容。
2. 缺少解析目标类型：parse_macro_input!需要明确指定要解析成的语法树类型，否则编译器无法推断正确返回类型，导致出现“expected (), found struct...”的错误。

修复方案 #

1. 使用适合普通代码的解析函数：在main这类非过程宏入口的代码中，改用syn::parse2()函数，它专门处理proc_macro2::TokenStream类型的输入。
2. 指定解析目标类型：明确告诉syn要将TokenStream解析成的语法树节点类型，比如这里输入的是函数定义，对应syn::ItemFn类型。

修复后的完整代码 #

extern crate proc_macro;
use proc_macro2::TokenStream;
use std::str::FromStr;
use syn::{self, ItemFn};
use quote;

fn main() {
    let ts = TokenStream::from_str("fn foo() {}").unwrap();
    let _ts_str = ts.to_string();
    // 使用parse2处理proc_macro2::TokenStream，指定解析为ItemFn类型
    let parsed: Result<ItemFn, syn::Error> = syn::parse2(ts);
    
    match parsed {
        Ok(item_fn) => println!("成功解析函数：{}", item_fn.sig.ident),
        Err(e) => println!("解析错误：{}", e),
    }
}

额外说明 #

• proc_macro::TokenStream只能在过程宏入口函数中使用（与编译器过程宏上下文绑定），而proc_macro2::TokenStream可在普通Rust代码中自由使用，适合调试过程宏逻辑。
• 若要在过程宏中调试核心逻辑，可将解析逻辑提取为接收proc_macro2::TokenStream的函数，既可以在普通main函数中测试，也能在过程宏入口中通过proc_macro2::TokenStream::from(token_stream)转换后调用。

内容的提问来源于stack exchange，提问作者Andrew Voelkel