015 · MkDocs Material 构建出现 MkDocs 2.0 长幅告警

问题现象

mkdocs build 输出中 Material 关于 MkDocs 2.0 的大段说明性横幅/告警，干扰日志阅读；构建本身可能仍成功（MkDocs 1.x）。

排查过程

对照上游文档，确认属 公告类 提示而非当前致命错误。

根因

Material 主动提示未来主版本迁移，非业务配置错误。

改进计划

在 mkdocs build 前 export NO_MKDOCS_2_WARNING=1（写入 /opt/rebuild-notes.sh 或 systemd Environment=）。

经验教训

区分 「构建失败」与「噪音日志」；噪音用环境变量或日志过滤收敛，避免掩盖真正的 fatal。