模块描述文件是协调多模块静态变量依赖的“指挥中枢”，通过声明初始化依赖图、生成注册表、分阶段初始化，将隐式链接器顺序转为显式可控流程，彻底规避SIOF。

模块描述文件本身不直接执行初始化，但它能成为协调多模块静态变量依赖关系的“指挥中枢”。核心思路是：把隐式的、由链接器决定的初始化顺序，转为显式的、由构建系统或运行时加载逻辑控制的配置流程。

用模块描述文件声明初始化依赖图

在模块描述文件（如 JSON/YAML 格式的 module.json 或 CMake 的 module.cmake）中，不写代码，而是声明模块间的初始化先后约束。例如：

• logger 模块 声明 "provides": ["log_service"]
• config 模块 声明 "requires": ["log_service"] 和 "initializes_after": ["logger"]
• database 模块 声明 "requires": ["config"]

这类声明不改变 C++ 编译行为，但可被构建脚本或启动框架读取，生成初始化调用序列或校验依赖闭环，提前暴露循环依赖。

驱动初始化函数注册表生成

模块描述文件可触发工具链自动生成初始化函数注册表。例如，每个模块提供一个 init_*.cpp 文件，内含类似：

void init_config_module() { Config::initialize(); }

模块描述文件列出所有模块的 init 函数路径，构建系统据此生成一个统一的 generated_init_registry.cpp，按依赖顺序调用：

• 先调 init_logger_module()
• 再调 init_config_module()
• 最后调 init_database_module()

所有全局静态变量改为惰性初始化（如用局部静态变量封装），真实初始化逻辑全部收口到这些显式函数中，彻底绕过 SIOF（Static Initialization Order Fiasco）。

配合模块加载时机做分阶段初始化

模块描述文件还可标注初始化阶段，比如：

• "phase": "early" → 用于基础服务（日志、内存池）
• "phase": "config" → 用于读取配置、解析参数
• "phase": "late" → 用于业务模块、网络监听等

主程序在 main() 中按 phase 分批调用初始化函数，确保基础静态资源就绪后再启动上层依赖。此时静态变量本身只作占位，真正构造推迟到对应 phase 的函数体内完成。

避免在描述文件里硬编码值，只管逻辑关系

模块描述文件不是配置文件替代品。它不存端口号、路径等具体值，也不写 Logger::level = 3 这类赋值语句。它的唯一职责是表达“谁必须在谁之前准备好”，让初始化从不可控变为可描述、可验证、可调试。