在 AI Coding 大量参与日常开发后，代码仓库里的冗余正在从偶发问题变成系统性问题。一次需求可能生成数十个文件，一轮重构可能留下多套旧实现，而项目仍能正常运行，让这些代码长期留在仓库中。开发者在两个 TypeScript 项目中运行静态分析工具 Knip 后，清理出了不少未使用的文件、导出和依赖，并通过 Git 历史追溯发现，其中不少正是快速实现、页面重构和 AI 生成代码留下的废弃路径。
AI Coding 提速后，冗余为什么会系统性积累
素材描述的现象很典型：开发者向 agent 提出一个简短需求，最终形成的 PR 可能包含数十个文件和数千行变更。只要功能可以运行，团队通常会继续推进下一个需求，而不会立即检查这些变更中有多少是必要实现，有多少只是临时方案，又有哪些已经被后续实现替代。
随着这类工作流反复进行，仓库中会逐渐积累几类残留：
- 快速实现需求时产生的临时文件和函数。
- 重构页面或模块后被替换下来、但未删除的旧页面、旧组件和工具函数。
- 多轮改动之间形成的过渡实现，表面结构完整，实际已不再被入口调用。
这些代码并不一定显得异常。它们有正常的命名、类型和目录结构，搜索时也会出现在结果里。下一次 AI agent 修改相关功能时，可能把它们当成当前实现参考，沿着已经过时的做法继续生成代码。仓库越混乱，判断哪套代码仍然有效就越困难。
Lint 与类型检查之外，Knip 补上“入口可达性”这一层
对于 TypeScript 项目，较严格的 lint 规则可以检查未使用的变量、参数和 import。但这类检查主要解决局部问题：一个文件内部引用关系成立，并不代表这个文件仍被整个项目使用。
素材举了一个简化例子：路由原来指向旧页面，旧页面引用旧组件，旧组件调用工具函数。重构后，路由切换到新页面，旧页面没有被删除。此时，旧页面中的 import 仍然在使用，旧组件里的函数也有调用方。从这些文件内部看，一切正常；但从应用入口看，已经没有任何路径能走到这套旧实现。
Knip 的核心能力是查找 JavaScript 和 TypeScript 项目中未使用的文件、导出和依赖。它会从入口文件出发，沿着引用关系分析项目，并结合 package.json 以及框架、工具插件识别更多入口。被纳入检查范围、但无法从入口抵达的文件，可能被报告为未使用。换句话说，它补上的不是局部语法检查，而是“这段代码是否还能从应用入口被走到”的可达性判断。
官方给出的 npm 接入示例为：
- npm init @knip/config
- npm run knip
素材同时注明，具体环境要求与配置应以官方文档为准。生成报告后，开发者可以让 agent 对照引用关系清理代码。Knip 也提供自动修复能力：–fix 可以处理部分未使用导出和依赖；删除文件则需要加上 –allow-remove-files。
不过，这类工具也有边界。Knip 需要先知道项目有哪些入口。如果项目中存在运行时拼接的加载路径，或者框架会自动发现某些文件，就可能需要补充配置。对于对外发布的库，仓库内暂时没有调用的公共 API 也不能直接删除。相关问题在官方文档中有说明。
结合 Git 历史，把清理变成可复用流程
这次实践并不止于跑一遍工具。开发者在清理完成后，让 agent 继续查看 Git 记录，追溯这些文件和导出是如何留下来的。结果显示，很多冗余可以对应到具体的开发过程：有些来自“快速实现一下这个需求”，有些来自“重构一下这个页面”后遗留的临时文件。新功能已经上线，旧代码却没有同步移除。
这类信息对工程团队的价值，不只是删除几个文件，而是能逐渐形成一套针对 AI 生成代码的清理流程：
- 先用 Knip 生成未使用文件、导出和依赖的报告。
- 再结合 Git 历史，判断这些代码是最初就多余，还是后来被新实现替代。
- 对确认无法从入口抵达、且不影响外部发布能力的部分进行清理。
- 把该流程纳入 AI Coding 后的常规维护，避免废弃路径持续积累。
这种做法也能降低后续 AI 修改代码时的误判风险。过时代码继续存在，会让 agent 和人一样把旧实现当作有效上下文。素材将其类比为“文档漂移”：过期内容仍在仓库里，后续判断就可能建立在错误前提上。
工程意义：不是替代架构判断，而是先清掉无人使用的部分
Knip 并不能判断业务架构是否合理。即使所有代码都有调用方，项目仍可能存在结构混乱、职责不清和实现重复等问题。架构层面的判断，仍需要有经验的工程师负责。
但在架构治理之前，先把无人使用的文件、导出和依赖清理出来，是一种成本较低、可重复执行的维护动作。尤其在 AI Coding 高频生成代码的场景下，仓库膨胀速度更快，冗余更容易被忽视。把入口可达性检查纳入日常工作流，可以帮助团队在继续利用 AI 提效的同时，减少旧代码对后续开发的干扰。
原创文章，作者：点点，如若转载，请注明出处：https://www.dian8dian.com/ai-bian-cheng-rang-cang-ku-yue-lai-yue-man-knip-ru-he-qing
