generatedregex 编译不生效需同时满足三个硬性条件：项目 sdk 为 microsoft.net.sdk 且目标框架 ≥ net7.0；csproj 中启用 true；正则模式必须是编译期常量（如 @"\d{3}-\d{2}-\d{4}"），不可含运行时变量或拼接。
GeneratedRegex 不是“更快的 Regex”，而是“没有 Regex 的 Regex”——它根本不会生成 Regex 实例，而是直接产出纯 C# 匹配逻辑。用错条件或误当普通 Regex 用，性能反而更差、编译直接失败。
为什么 GeneratedRegex 编译不生效？三个硬性条件缺一不可
源生成器静默跳过（不报错也不生成代码）是最常见的问题。它只在同时满足以下全部条件时才工作：
- 项目 SDK 必须是
Microsoft.NET.Sdk（即标准 SDK 风格），且<targetframework></targetframework>≥net7.0 -
.csproj中显式启用：<isregularexpressionssourcegeneratorenabled>true</isregularexpressionssourcegeneratorenabled>（<enabledefaultregexgenerator>true</enabledefaultregexgenerator>在 .NET 8+ 已废弃） - 正则模式必须是编译期常量：只能是
@"\d{3}-\d{2}-\d{4}"这类字面量或const string，不能含变量拼接、string.Format、配置读取、环境变量等任何运行时成分
常见错误现象：Patterns.SsnRegex() 调用后仍走慢路径、IDE 没有自动补全 IsMatch(ReadOnlySpan<char>)</char> 扩展方法、编译输出里看不到生成的 Patterns.g.cs 文件——基本就是这三个条件中至少一个没卡准。
GeneratedRegex 方法签名必须是 static partial，且返回 Regex
你写的是一个“声明”，不是“实现”。编译器根据这个声明生成完整逻辑，所以语法约束极严：
- 必须是
static partial方法（不能是字段、属性、普通方法、async方法） - 返回类型必须是
Regex（不能是object、var或自定义包装类型） - 参数列表必须为空（不支持传入
RegexOptions运行时参数；选项只能写在[GeneratedRegex(...)]特性里）
正确示例：[GeneratedRegex(@"\b\w+\b", RegexOptions.IgnoreCase)]public static partial Regex WordRegex();
错误示例：public static Regex WordRegex() => new(...);（手写实现 → 跳过生成）public static partial bool TryMatch(...)（返回 bool → 是 RegexGenerator，不是 GeneratedRegex）
GeneratedRegex 不支持 RegexOptions.Compiled，也不需要
RegexOptions.Compiled 和 GeneratedRegex 是两条完全不同的优化路径，混用会触发编译错误或静默降级：
-
[GeneratedRegex("...", RegexOptions.Compiled)]→ 编译失败，提示 “Compiledis not supported for source-generated regexes” - 即使去掉
Compiled，但你在调用时又写Patterns.Email().Match(...)→ 仍会触发Regex类的通用匹配路径，失去源生成优势 - 真正发挥性能的关键是：用生成的扩展方法，例如
"test@example.com".IsMatch(Patterns.Email())或input.AsSpan().IsMatch(Patterns.Email())
原因：源生成器不仅生成 Email() 方法，还会为它配套生成一整套 IsMatch/Match/Matches 扩展方法（位于 System.Text.RegularExpressions 命名空间下），这些方法内部直接调用生成的 TryMatch，绕过 Regex 类的所有抽象层和状态机调度。
捕获组、命名组与性能边界在哪里？
GeneratedRegex 支持捕获组，但处理方式和传统 Regex 有本质区别：
- 无
GroupCollection分配：捕获内容通过out Range参数返回，例如bool TryMatch(ReadOnlySpan<char> input, out Range user, out Range host)</char> - 命名组需显式启用：.NET 7 默认不解析命名组语义；要生成带命名参数的
MatchAs<t>()</t>，需额外加[GeneratedRegex(..., RegexOptions.ExplicitCapture)]并配合RegexGeneratorOptions（.NET 8+ 更稳定） - 复杂回溯模式会被拒绝：含
.*?、嵌套量词、平衡组等高成本结构的表达式，源生成器可能无法静态展开，直接报错 “pattern cannot be source-generated”
容易被忽略的一点：生成的代码是**针对该正则模式完全特化的**。这意味着它无法像 Regex 实例那样复用同一个对象处理不同输入——但它也不需要复用，每次调用都是零开销函数调用。真正的瓶颈从来不在“复用”，而在“解释/编译/反射”这三层 runtime 开销，而 GeneratedRegex 把这三层全砍了。
