用途:运行 Knip 可发现并移除代码库中未使用的文件、依赖和导出,用于清理死代码与未使用依赖。它不负责删除文件内部的未使用导入/变量,那属于 linter 的职责。
主要能力:检测未使用文件、dependencies、devDependencies、exports 与 types;支持通过配置减少误报;提供 --production 仅关注生产代码,--fix 自动修复安全变更,--fix --allow-remove-files 可删除文件,--reporter json 输出 JSON。
使用方式:先检查可用性 npx knip --version;未安装则 npm install -D knip(或按 lockfile 使用 pnpm/yarn/bun)。采用配置优先流程:先理解项目框架与现有配置(knip.json、knip.jsonc 或 package.json 的 knip 键),运行 npx knip 并优先处理顶部配置提示,调整配置后重复,直到提示解决、误报最小化,再按顺序处理未使用文件、依赖、devDependencies、导出、类型,每批修复后重跑。
配置建议:避免使用 ignore 模式;导出类型多可加 ignoreExportsUsedInFile: { interface: true, type: true };不要重复 .gitignore 已覆盖的 node_modules、dist、build、.git;不要重复插件默认入口;配置文件被标为未使用应显式启用/禁用对应插件;Node 内置模块依赖加入 ignoreDependencies;路径别名未解析则补充 paths。
限制与注意:仅用于项目级清理,不处理文件内未使用项;monorepo 可能需要 --workspace;部分框架需在配置中启用插件;退出码 2 常见于配置加载错误,需检查或创建 knip.json,并参考 knip.dev 排查。自动删除前对可能为入口、公开 API 或动态导入的内容应先确认。