.gitignore 规则测试器 - 验证文件是否被忽略

第一步：了解界面布局

打开工具页面后，你会看到上方的规则输入区域和下方的测试路径输入区域。规则输入区域支持多行文本，每行一条规则，以井号开头的行为注释行会被自动忽略。测试路径输入区域支持单行或多行输入，每行一个文件路径。界面右侧展示了四种预设规则的快捷按钮和八个常用测试路径的快捷按钮。

第二步：输入或选择规则

你可以在规则输入框中手动输入 .gitignore 规则，也可以点击预设按钮快速加载。例如，如果你正在开发 Node.js 项目，点击"Node.js"按钮即可加载包含 node_modules、dist、.env 等常见忽略路径的规则集。规则输入完成后，点击"解析规则"按钮，工具会自动提取并展示所有有效规则（忽略注释行和空行）。

第三步：输入测试路径

在测试路径输入框中输入你想要验证的文件或目录路径。路径应该是相对于项目根目录的相对路径，例如 node_modules/express/index.js 或 src/utils/.env。你也可以点击右侧的快捷测试路径按钮，一键填入常见的测试路径。支持同时输入多个路径进行批量测试。

第四步：执行测试并查看结果

点击"开始测试"按钮，工具会立即对每条规则与每个测试路径进行匹配计算。测试结果以表格形式展示，行表示规则，列表示路径。每个单元格用颜色标注匹配结果：绿色背景表示该路径会被该规则忽略，红色背景表示不会被忽略。点击任意单元格可以展开查看详细的规则解析。

第五步：解读规则解析

展开规则解析后，你会看到该规则的逐字符分析。工具会解释每个特殊字符的含义、匹配的范围、路径层级的匹配过程。例如，规则 node_modules/** 会解析为：node_modules 匹配根目录下的 node_modules 目录，/** 递归匹配该目录下的所有子路径。理解这些解析有助于你编写更精确的 .gitignore 规则。

第六步：调试常见问题

如果你发现某条规则没有按预期工作，可以使用规则解析功能排查原因。常见的问题包括：规则路径前是否有斜杠（影响根目录匹配）、是否需要使用双星号进行递归匹配、文件是否已经被 Git 追踪（已追踪的文件不受 .gitignore 影响）。工具的解析详情会帮助你快速定位这些问题。

第七步：导出和应用

测试通过后，你可以将验证好的规则直接复制到项目的 .gitignore 文件中。建议在项目初始化阶段就配置好 .gitignore，并在后续开发中持续维护。使用本工具定期检查规则的正确性，可以避免将不必要的文件提交到代码仓库中。