用途:将项目中运行时的正则表达式转换为编译期源生成的实现,适用于希望优化正则性能或需要 AOT(Native AOT)与裁剪兼容的场景。
主要能力:源生成的正则在编译期生成匹配代码,具备 AOT 兼容、可调试(可单步进入生成的匹配代码)、无运行期编译开销等特性;生成的方法内部会缓存单例。触发场景包括:优化正则性能、需要 AOT 兼容模式、讨论 [GeneratedRegex] 特性、把 new Regex(...) 改为源生成形式、讨论正则编译或启动性能。
使用方式:在代码库中查找 new Regex(...)、Regex.IsMatch()、Regex.Match()、Regex.Replace() 等含内联模式的正则用法;对模式在编译期已知的正则,确保所在类为 partial,创建带 [GeneratedRegex] 特性的 partial 方法,例如: [GeneratedRegex("pattern", RegexOptions.IgnoreCase)] private static partial Regex MyRegex(); 方法名按匹配内容描述性命名,再把原调用替换为生成的静态方法,例如用 MyNumberRegex().IsMatch(input) 替代 new Regex(@"\d+", RegexOptions.Compiled);最后用 dotnet build 验证。
注意事项与限制:RegexOptions.Compiled 会被源生成忽略,应移除;需要 .NET 7 或更高版本;超时可通过 [GeneratedRegex("pattern", RegexOptions.None, 1000)] 以毫秒指定。若模式不是编译期常量则不能使用源生成,保留运行期正则;若类不是 partial 需加上 partial 修饰符;转换后构建失败需检查报错信息中的不支持模式特性。性能与 AOT 之外的具体收益资料暂未提供。