Knip项目中忽略规则在package.json脚本中失效的问题分析

Knip是一个用于JavaScript/TypeScript项目的代码分析和依赖关系检查工具。近期在5.10.0-canary.0版本及更高版本中发现了一个重要问题：工具在处理package.json文件中的脚本时，未能正确遵守配置的忽略规则。

问题背景

在典型的TypeScript项目结构中，源代码通常存放在src目录下，编译后的输出则放置在dist目录中。按照惯例，dist目录会被添加到.gitignore文件中，同时也会在knip配置中明确忽略。这种配置的目的是让工具只分析源代码，而不检查编译后的输出文件。

然而，当package.json中的脚本（如启动脚本）引用了dist目录中的文件时，Knip从5.10.0-canary.0版本开始会错误地分析这些被明确忽略的文件。

技术细节分析

通过调试输出可以清楚地看到问题所在。Knip正确地解析了.gitignore和knip.json中的忽略规则，包括对dist目录的忽略设置。但在实际分析阶段，工具仍然会处理dist/index.js文件，即使该文件路径匹配忽略模式。

这种行为变化出现在5.9.4版本到5.10.0-canary.0版本之间，表明相关变更可能影响了文件路径处理逻辑。特别值得注意的是，Knip在分析阶段会将dist/index.js和src/index.ts都列为"已解析文件"，这直接违反了用户的忽略配置。

影响范围

这个问题会影响所有满足以下条件的项目：

1. 使用TypeScript并输出到特定目录（如dist）
2. 在package.json脚本中引用编译后的文件
3. 使用Knip 5.10.0-canary.0或更高版本

对于这类项目，Knip会错误地报告与编译输出相关的问题，可能导致开发人员处理实际上不需要关注的警告或错误。

解决方案

项目维护者已经修复了这个问题。对于遇到此问题的用户，建议：

1. 升级到包含修复的Knip版本
2. 检查项目中的忽略配置是否完整
3. 验证Knip是否不再分析被忽略的目录

这个修复确保了工具行为与用户预期一致，即严格遵守配置的忽略规则，无论文件是如何被引用的。