Textlint 文件路径忽略功能的重构与优化

Textlint 作为一款流行的文本检查工具，近期对其文件路径忽略功能进行了重要重构。本文将深入分析此次改进的技术细节和实际意义。

核心问题分析

Textlint 原有的忽略功能存在三个主要技术缺陷：

1. 缺乏判断路径是否被忽略的API：开发者无法通过编程方式确认某个文件路径是否被忽略规则匹配
2. 文件路径参数不应用忽略规则：当直接传递文件路径而非glob模式时，忽略规则完全失效
3. 忽略行为的反馈机制缺失：用户无法区分文件是被有意忽略还是意外未被处理

技术解决方案

新增 isPathIgnored API

Textlint 14.1.0版本引入了类似ESLint的isPathIgnored方法，允许开发者明确检查特定路径是否被忽略。这个API与lintText方法形成良好配合，前者检查路径，后者执行实际检查。

重构文件查找工具

项目团队彻底重写了find-utils模块，主要改进包括：

• 迁移到globby库替代原有glob实现
• 增强gitignore兼容性
• 确保文件路径参数同样应用忽略规则

行为模式优化

重构后的路径处理遵循以下原则：

输入类型	不支持的扩展名	被忽略路径	不存在目录	不存在路径
文件路径	警告	警告	错误	错误
Glob模式	不处理	不处理	不处理	不处理
Shell展开路径	警告	警告	错误	错误

实际应用建议

开发者现在可以更可靠地构建文本检查流程：

const { createLinter } = require("textlint");
const linter = createLinter(/* 配置 */);

// 检查路径是否被忽略
if (!linter.isPathIgnored("README.md")) {
    // 执行检查
    const results = await linter.lintText(content, "README.md");
}

技术价值

这次重构不仅修复了长期存在的功能缺陷，更重要的是：

1. 提升了与现有工具链的兼容性
2. 使忽略行为更加符合开发者预期
3. 为更复杂的文本处理场景奠定了基础

这些改进使Textlint在自动化文本检查流程中表现更加可靠和专业。