Visual Studio批量XML文档编辑：可变捕获组正则替换难题

一、为什么Visual Studio原生正则替换无法实现 #

原生正则不支持可变数量捕获组的引用，你能选中注释内容，但没法循环处理每一行的匹配结果，纯正则逻辑无法完成这种需要遍历行的批量替换，必须结合编程逻辑才能实现。

二、Visual Studio扩展替代方案 #

• Regex Find and Replace：功能比原生正则更强大，支持嵌入C#脚本片段处理匹配内容，能直接在VS内完成批量行处理
• Resharper：自带结构搜索替换工具，可针对XML注释的结构配置替换模板，一键完成<summary>内的行标签注入
• Comment Formatter：专注注释格式化的扩展，支持自定义规则，可配置给<summary>内每行自动添加<br>标签

三、正则代码彩色格式化方法 #

• 安装Regex Editor Kit扩展：自带正则语法高亮，能区分捕获组、元字符、量词等元素，还支持实时预览匹配结果
• 开启VS原生语法着色：在「选项→文本编辑器→常规」中，勾选「启用正则表达式语法着色」，部分版本需手动开启该功能

四、编程实现的简易思路 #

如果不想依赖扩展，可编写小工具批量处理：

1. 遍历项目内所有.cs文件
2. 用正则匹配<summary>与</summary>之间的内容块
3. 将内容块按换行分割，给每行包裹<br>标签（可跳过空行）
4. 替换原内容后写回文件

示例代码片段（C#）：

using System.IO;
using System.Text.RegularExpressions;

var targetDir = @"你的项目根路径";
var csFiles = Directory.GetFiles(targetDir, "*.cs", SearchOption.AllDirectories);

foreach (var file in csFiles)
{
    var content = File.ReadAllText(file);
    content = Regex.Replace(content, @"<summary>(.*?)</summary>", match =>
    {
        var lines = match.Groups[1].Value.Split(new[] { "\r\n", "\n" }, StringSplitOptions.RemoveEmptyEntries);
        var formattedLines = lines.Select(line => $"<br>{line.Trim()}</br>");
        return $"<summary>{string.Join("\r\n", formattedLines)}</summary>";
    }, RegexOptions.Singleline);
    
    File.WriteAllText(file, content);
}

内容的提问来源于stack exchange，提问作者Andrea Bardelli