C#读取.gitignore文件方法解析
Gitignore规则使用Git专属glob语法而非正则表达式，需用Microsoft.Git.Cli的PathSpec解析以准确匹配路径、支持**、!取反及目录语义。
Git ignore规则使用Git专属glob语法而非正则表达式，需用Microsoft.Git.Cli的PathSpec解析以准确匹配路径、支持**、!取反及目录语义。
Git ignore 规则不是正则，别直接用 Regex 匹配
很多人第一反应是把 .gitignore 每行当正则写进 Regex，结果发现 **/build/、!src/*.cs、log?.txt 全都匹配错——因为 Git 的 glob 语义和 .NET 的 Regex 或 FileSystemEnumerable 完全不同。它支持路径层级通配（**）、取反（!）、斜杠敏感、前导空格/注释忽略等，必须按 Git 规范解析。
用 LibGit2Sharp 不行，它不暴露 ignore 规则解析逻辑
LibGit2Sharp 能判断某个路径是否被忽略（如 Repository.Index.IsPathIgnored()），但它不提供规则加载、编译或调试能力。你无法知道是哪条规则生效、为什么某文件没被过滤、如何复现本地 git check-ignore -v 的行为。真要调试规则链或做构建工具级过滤（比如 MSBuild 前扫描源码），必须自己解析。
手动解析的关键三步：读取 → 编译 → 匹配
核心是把每行规则转成可执行的谓词（Func），再按顺序应用（注意：后出现的规则可覆盖前面的同路径规则，! 取反优先级高）：
- 逐行读取
.gitignore，跳过空行、以#开头的注释行 - 对非空行：去掉首尾空白，识别是否以
!开头；然后将剩余部分转为路径匹配逻辑（例如**/obj/→ “路径中任意深度包含/obj/”；*.tmp→ “文件名后缀为.tmp”，且只作用于当前目录层级） - 构建匹配器时，注意 Git 的“目录标记”语义：末尾带
/（如bin/）只匹配目录，不带则既匹配文件也匹配目录；**只在路径中间有效，开头的**/表示递归，结尾的/**表示该目录下所有内容
简单示例（仅处理常见情况）：
// 简化版规则编译（实际需更完整）
string pattern = line.TrimStart('!', ' ');
bool isNegation = line.StartsWith("!");
bool isDirectoryOnly = pattern.EndsWith("/");
pattern = pattern.TrimEnd('/');
Func matcher = path => {
if (isDirectoryOnly && !path.EndsWith("/")) return false;
if (pattern.Contains("")) {
// 处理 /src/.cs 这类
var parts = pattern.Split(new[] { "" }, StringSplitOptions.None);
return parts.All(p => string.IsNullOrEmpty(p) || path.Contains(p));
}
// 实际应使用类似 Microsoft.Git.Cli 的 PathSpec.Match
};
推荐直接用 Microsoft.Git.Cli 的 PathSpec
微软官方开源的 Microsoft.Git.Cli（NuGet 包）里有生产级 PathSpec 实现，完全兼容 Git CLI 行为，支持 **、!、括号扩展、大小写敏感控制等。它不依赖 libgit2，纯 C# 实现，可直接引用：
- 安装：
dotnet add package Microsoft.Git.Cli - 加载规则：
var spec = new PathSpec(File.ReadAllLines(".gitignore")); - 判断路径：
bool ignored = spec.Matches("src/Program.cs").IsExcluded;（返回MatchResult，含详细匹配信息） - 注意：它默认按 Unix 路径分隔符
/解析，Windows 下传入路径建议先.Replace('\\', '/')
这个库的 PathSpec 是目前 .NET 生态中最接近 Git 原生行为的实现，比手写健壮得多，但文档极少——关键点藏在单元测试里，比如 PathSpecTests 中的 ShouldMatchWithDoubleAsterisk 用例。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
