编译Wasm目标时proc-macro-error过程宏依赖编译报错求助

核心原因 #

你的过程宏crate未被Cargo正确识别为仅编译时执行的过程宏，导致客户端编译Wasm目标时，错误地尝试将proc-macro-error及其依赖的proc-macro相关代码编译到Wasm环境中——而proc-macro系列API仅在主机（原生）编译环境中可用，Wasm目标不支持这些API。

具体解决步骤 #

1. 修正宏crate的Cargo.toml配置
   在宏crate的Cargo.toml中，必须明确标记proc-macro = true，告诉Cargo这是一个过程宏crate：

   [lib]
   proc-macro = true
   

   这是最关键的一步，缺少该配置时，Cargo会将其当作普通库处理，进而编译到目标二进制中。

2. 检查客户端项目的依赖配置
   客户端依赖宏crate时无需特殊标记（只要宏crate本身是proc-macro类型），Cargo会自动将其视为编译时依赖。若客户端同时依赖宏crate的运行时代码，需将过程宏代码与运行时代码拆分到两个独立crate，或用条件编译隔离：

   # 客户端Cargo.toml
   [dependencies]
   # 仅编译时使用的宏依赖
   your-macro-crate = { version = "x.y.z" }
   # 单独依赖运行时代码crate
   your-runtime-crate = { version = "x.y.z" }
   

3. 排查宏crate中的非过程宏代码
   若宏crate包含运行时执行的代码（未标注#[proc_macro]等宏属性的函数），且这部分代码调用了proc-macro-error的API，会导致Wasm编译出错。解决方式：

   • 将过程宏代码与运行时代码拆分到两个独立crate（如your-crate-macro和your-crate）
   • 用条件编译隔离proc-macro相关代码：

     #[cfg(proc_macro)]
     use proc_macro_error::*;
     
     #[cfg(proc_macro)]
     #[proc_macro]
     pub fn your_macro(input: TokenStream) -> TokenStream {
         // 过程宏代码，仅在编译时执行
     }
     

4. 升级proc-macro-error到最新稳定版
   旧版本的proc-macro-error可能存在Wasm目标兼容问题，执行以下命令升级：

   cargo update proc-macro-error
   

5. 强制客户端仅在编译时依赖宏crate
   若以上步骤无效，可在客户端的Cargo.toml中将宏crate标记为构建依赖：

   [build-dependencies]
   your-macro-crate = { version = "x.y.z" }
   

   同时在客户端代码中通过extern crate your_macro_crate;引入。

验证方法 #

修改配置后清理编译缓存，再重新编译Wasm目标：

cargo clean
cargo build --target wasm32-unknown-unknown

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