Module Initializer 是为了让库/框架在程序集加载时,以 “CLR 保证的、只运行一次的、不依赖类型访问的” 方式执行初始化逻辑,从而避免静态构造函数的副作用和性能问题。
为什么需要 Module Initializer?
1. 静态构造函数的问题
- 触发时机不确定:CLR 保证在第一次访问类型前调用静态构造函数,但 你无法精确控制它什么时候运行。
- 性能开销:CLR 对静态构造函数的类型会加锁,防止并发初始化,这会带来性能损耗。
- 不能跨类型共享初始化逻辑:每个有静态构造函数的类都要单独处理,无法集中初始化。
2. 模块初始化器的优势
- 只运行一次:在程序集加载时 由 CLR 自动调用一次,不依赖任何类型访问。
- 无类型访问开销:不需要触发某个类型的静态构造函数来“顺便”初始化。
- AOT 兼容的初始化逻逻辑
using System.Runtime.CompilerServices;class Program {static void Main(){Console.WriteLine("Main");} }class Init {[ModuleInitializer]public static void Initialize(){Console.WriteLine("Module Initializer runs before Main!");} }
输出:
Module Initializer runs before Main!
Main