C# 正則表達式速查手冊：常用驗證模式、分組捕獲、替換、性能優化、RegexOptions 詳解

正則表達式是文本處理的瑞士軍刀。本文匯總**高頻驗證模式**、**核心語法詳解**、**C# Regex 進階用法 (命名分組、替換委托、預編譯、Span 支持)**、以及**性能優化陷阱**，作為開發隨查手冊。

一、高頻驗證模式庫 (可直接複製)

二、核心語法速查

三、C# Regex 進階實戰模式

1. 命名分組 + 強類型提取 (推薦)

string pattern = @"^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$";
string input = "2023-10-01";

var match = Regex.Match(input, pattern);
if (match.Success)
{
    int year = int.Parse(match.Groups["year"].Value);
    int month = int.Parse(match.Groups["month"].Value);
    int day = int.Parse(match.Groups["day"].Value);
    // match.Groups["year"] 等同 match.Groups[1]，但可讀性強、重構安全
}

2. 替換委托：動態計算替換值

// 將所有數字乘以 2
string input = "價格: 10, 20, 30";
string result = Regex.Replace(input, @"\d+", m => (int.Parse(m.Value) * 2).ToString());
// 結果: "價格: 20, 40, 60"

// 複雜邏輯：根據上下文決定替換
result = Regex.Replace(input, @"(?<prefix>\$)(?<amount>\d+)", m => 
    $"{m.Groups["prefix"].Value}{decimal.Parse(m.Groups["amount"].Value) * 1.1m:F2}");

3. 分割保留分隔符

// 保留標點符號分割句子
string text = "你好！世界。真好？";
var parts = Regex.Split(text, @"(?<=[。！？])"); 
// 結果: ["你好！", "世界。", "真好？", ""]

4. 多行模式處理日志/代碼

string log = @"2023-10-01 10:00:01 INFO  啟動
2023-10-01 10:00:02 ERROR 連接失敗
2023-10-01 10:00:03 WARN  重試";

// ^ 和 $ 匹配行首行尾
var errors = Regex.Matches(log, @"^.*ERROR.*$", RegexOptions.Multiline);
// 單行模式：. 匹配換行
var block = Regex.Match(log, @"ERROR.*?WARN", RegexOptions.Singleline);

5. .NET 7+ Span/ReadOnlySpan 支持 (零分配)

// Regex.IsMatch / Match / Count / EnumerateMatches 支持 ReadOnlySpan
ReadOnlySpan span = "abc123def".AsSpan();
bool hasDigit = Regex.IsMatch(span, @"\d"); // true, 無字符串分配

// 枚舉匹配 (高性能，無 Match 對象分配)
foreach (var match in Regex.EnumerateMatches(span, @"\d+"))
{
    // match 是 ValueMatch 結構體，包含 Index, Length
    var numSpan = span.Slice(match.Index, match.Length);
    int num = int.Parse(numSpan); // .NET 7+ 支持 Span 解析
}

四、RegexOptions 詳解

五、性能優化鐵律

1. 靜態預編譯：高頻正則定義為 `static readonly Regex _regex = new Regex(pattern, RegexOptions.Compiled);` 避免重複編譯。
2. 避免災難性回溯：嵌套量詞 (a+)+、互斥選項重疊 (a|a*)+。使用**原子組** (?>...) 或**佔有優先量詞** ++ *+ ?+ (需 .NET 支持) 防回溯。
3. 錨點優先：模式開頭加 ^ 或 \b，失敗快。
4. 具體化字符集：用 [a-f0-9] 代替 . 或 \w。
5. 複用 Match/Enumerator：大文本用 EnumerateMatches (Span) 或 Match.NextMatch()，避免 Matches() 一次性分配集合。
6. 緩存實例：`Regex` 實例**線程安全**，可全局靜態緩存。

六、常用工具方法封裝

public static class RegexHelper
{
    // 預編譯常用正則
    private static readonly Regex _emailRegex = new Regex(
        @"^[\w-\.]+@([\w-]+\.)+[\w-]{2,}$", 
        RegexOptions.Compiled | RegexOptions.IgnoreCase);

    private static readonly Regex _mobileRegex = new Regex(
        @"^1[3-9]\d{9}$", 
        RegexOptions.Compiled);

    public static bool IsEmail(string s) => !string.IsNullOrEmpty(s) && _emailRegex.IsMatch(s);
    public static bool IsMobile(string s) => !string.IsNullOrEmpty(s) && _mobileRegex.IsMatch(s);

    // 通用提取首個匹配分組值
    public static string Extract(string input, string pattern, string groupName = "value")
    {
        var m = Regex.Match(input, pattern);
        return m.Success ? m.Groups[groupName].Value : null;
    }

    // 高亮關鍵字 (HTML)
    public static string Highlight(string html, string keyword, string cssClass = "highlight")
    {
        if (string.IsNullOrEmpty(keyword)) return html;
        string escaped = Regex.Escape(keyword);
        return Regex.Replace(html, $"({escaped})", $"$1", RegexOptions.IgnoreCase);
    }
}

總結

正則表達式威力巨大，但**可讀性差、易出災難性回溯、調試困難**。原則：**能用字符串方法 (`Contains`、`StartsWith`、`Split`、`IndexOf`、`Span` 切片) 解決的，絕不寫正則**；必須用時：**命名分組、靜態預編譯、詳盡註釋、單元測試覆蓋邊界**。推薦工具：regex101.com (實時調試、解釋、代碼生成)、RegexStorm (.NET 專用測試)。