如何在不导出内部宏的情况下在已导出宏中使用它？

解决方案 #

• 给内部宏加#[macro_export]+#[doc(hidden)]
  这种方式既让内部宏能被导出宏正常调用，又不会把它暴露给外部用户（文档里不会显示）。示例代码：

  // 内部模块里的宏
  #[macro_export]
  #[doc(hidden)]
  macro_rules! macro_intern {
      () => { println!("执行内部宏逻辑") };
  }
  
  #[macro_export]
  macro_rules! macro_exported {
      () => {
          macro_intern!();
      };
  }
  

• 直接内联内部宏逻辑
  如果macro_intern的逻辑比较简单，直接把它的代码合并到macro_exported中，彻底绕开内部宏的导出问题。

为什么Rust不自动展开未导出的内部宏？ #

• 宏展开时机的限制：声明式宏是在用户调用处才展开，而非你编写导出宏的阶段。提前展开会丢失调用处的上下文信息（比如局部变量、类型推导结果），导致宏无法正常工作。
• 宏可见性的规则：未用#[macro_export]标记的内部宏仅在 crate 内可见。当外部 crate 调用你的导出宏时，展开过程需要解析macro_intern!()，但外部 crate 找不到这个未导出的宏，必然报错。而私有函数是编译成机器码后被引用，和宏的语法层面展开完全不是一个处理阶段。
• 模块化设计的考量：自动展开会破坏宏的复用性，让导出宏的展开结果变得冗余，违背了用内部宏拆分逻辑的初衷。

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