模块描述文件是协调多模块静态变量依赖的“指挥中枢”，通过声明初始化依赖图、生成注册表、分阶段初始化，将隐式链接器顺序转为显式可控流程，彻底规避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 文件，内含类似：
模块描述文件列出所有模块的 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 这类赋值语句。它的唯一职责是表达“谁必须在谁之前准备好”，让初始化从不可控变为可描述、可验证、可调试。
