如何在Rust中实现宏卫生调用函数并支持 crate 内外兼容？

要让导出的宏在 crate 内部和外部都能正确调用模块内的函数，关键是使用Rust宏提供的特殊路径变量$crate，它专门用于处理宏中的跨 crate 路径解析问题。

问题根源 #

宏是在调用位置展开的，所以宏内的路径是相对于调用处的：

• 用crate::a::b::foo时，在 crate 内部能正常解析，但外部导入宏后，crate指向的是调用者的 crate，而非定义宏的 crate，导致找不到函数。
• 硬编码::mycratename::a::b::foo时，外部调用可能正常，但 crate 内部使用时，当前 crate 的路径标识是crate::而非::mycratename::，编译器会报错找不到该路径。

正确解决方案 #

使用$crate替代固定的路径前缀，它会在宏展开时自动适配：

• 在 crate 内部调用时，$crate等价于crate::
• 在外部 crate 调用时，$crate等价于::mycratename::（即你的 crate 名称）

修改后的完整代码如下：

mod a {
    mod b {
        pub fn foo(_: u32) {}
    }
}

#[macro_export]
macro_rules! bar {
    ($x:expr) => ($crate::a::b::foo($x))
}

验证场景 #

1. crate 内部使用：直接调用bar!(123);即可，$crate会解析为crate::，正确指向crate::a::b::foo。
2. 外部 crate 使用：先在依赖的Cargo.toml中添加你的 crate，然后导入宏并调用：

   use mycratename::bar;
   
   fn main() {
       bar!(456);
   }
   

   此时$crate会解析为::mycratename::，正确找到目标函数。

注意事项 #

确保被调用的foo函数是pub的——如果要导出宏供外部使用，必须公开目标函数；若仅在 crate 内部使用宏，函数可以不公开。

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