我之前维护Rust库时也碰到过几乎一模一样的需求——想给每个文件标记稳定/不稳定状态，自动生成对应的编译配置和文档注释，还不想把标记信息散落到其他文件里。折腾过程宏碰壁之后，终于找到几个可行的方案，给你参考下：

方案一：用声明宏直接生成文件级属性（最推荐） #

过程宏确实搞不定这个，因为Rust的过程宏只能处理「项（Item）」，而文件级的内部属性（#!开头的那种）不属于Item范畴，编译器根本不会把过程宏输出的#!属性当成文件级配置。但**声明宏（macro_rules!）**可以做到，因为它是在语法解析阶段做文本式的展开，只要你把宏调用放在文件的最开头，展开后的内容就会被当成文件级的属性和文档。

具体实现步骤：

1. 先在你的库的根模块（比如lib.rs）里定义两个声明宏，分别对应稳定和不稳定状态：

// 在lib.rs里全局定义，所有模块都能调用
macro_rules! mark_unstable {
    () => {
        // 开启unstable feature时才编译这个模块
        #![cfg(feature = "unstable")]
        // 不稳定模块允许未使用的代码（比如实验性的API）
        #![warn(unused)]
        //! 🔴 该模块处于**不稳定状态**
        //! API可能在未提前通知的情况下随时变更，请勿在生产环境依赖
    };
}

macro_rules! mark_stable {
    () => {
        // 开启stable feature时才编译这个模块
        #![cfg(feature = "stable")]
        // 稳定模块强制要求完整的文档
        #![deny(missing_docs)]
        //! 🟢 该模块处于**稳定状态**
        //! API遵循语义化版本承诺，非重大版本不会变更
    };
}

2. 然后在需要标记的文件的最开头调用对应的宏：

// 这是某个不稳定模块的文件开头，必须第一行就调用
mark_unstable!();

// 下面是模块的实际代码
pub fn experimental_api() {
    // ...
}

这个方案完全符合你的需求：

• 标记信息只在当前文件里，不用在其他文件的模块导出处重复写
• 自动生成文件级的编译配置（cfg）、lint规则和rustdoc注释
• 没有额外的编译开销，完全是Rust原生的语法展开

注意点：宏调用必须放在文件的绝对第一行，不能有任何空行、注释或者其他代码在它前面，否则展开后的#!属性会被当成普通项的一部分，导致编译错误。

方案二：用自定义Lint强制规范（进阶需求） #

如果你担心团队成员忘记调用宏，或者调用了错误的宏，可以配合自定义Lint来做强制检查。比如用dylint（稳定的自定义Lint工具，不用依赖nightly编译器）写一个Lint：

• 检查每个.rs文件的开头是否有mark_stable!()或mark_unstable!()的调用
• 检查展开后的属性是否符合稳定/不稳定的规则（比如稳定模块必须开启deny(missing_docs)）

这个方案需要额外写点Lint代码，但能在编译阶段就把问题拦下来，比CI检查更及时。

方案三：轻量版Build.rs扫描（备选） #

如果你因为某些原因不能用声明宏，可以优化你之前想到的Build.rs方案，把开销降到最低：

• 只扫描每个.rs文件的前10行，找你约定的标记注释（比如// STABILITY: unstable）
• 不用修改原文件，而是生成一个单独的stability_markers.rs文件，里面用cfg_attr给每个模块标记对应的feature
• 然后在你的库里引用这个自动生成的文件，确保编译时的配置正确

不过这个方案比宏的方式麻烦，而且多了Build.rs的步骤，除非你有跨模块统计稳定性的需求，否则不推荐。

最后，如果你暂时没法用上面的方案，用CI检查作为过渡也可以，但确实不如在编译阶段解决来得优雅。我自己维护的库现在用的是方案一+自定义Lint的组合，挺顺畅的，你可以试试～