depcheck、knip 和 npm-check 都是用于分析和管理项目依赖的工具,帮助开发者识别未使用、过时或缺失的 npm 包。depcheck 专注于通过静态分析检测未被引用的依赖;knip 提供更全面的项目健康检查,涵盖依赖、文件、导出等多个维度,并具备上下文感知能力;npm-check 则提供交互式界面用于更新或删除依赖,但已长期停止维护。这些工具的目标是提升项目整洁度、减小 bundle 体积并增强可维护性。
在现代前端工程中,项目依赖往往随着时间推移变得臃肿甚至冗余。清理无用依赖不仅能减小构建体积,还能提升安全性和可维护性。depcheck、knip 和 npm-check 是三个常被提及的工具,但它们的设计理念、能力边界和适用场景大不相同。本文从真实开发视角出发,深入剖析三者的异同。
depcheck 专注于识别 未被使用的 npm 依赖(包括 devDependencies)。它通过静态分析源码(如 .js, .ts, .jsx, .tsx 等)来判断哪些包被实际引用,并报告那些安装了却从未被 require() 或 import 的包。
# depcheck 基本用法
npx depcheck
knip 的定位更广:它是一个 项目健康检查工具,不仅检测未使用的依赖,还检查未使用的文件、重复导出、缺失依赖、过时配置等。其核心是“发现项目中不该存在或缺失的东西”。
# knip 基本用法
npx knip
npm-check 则聚焦于 交互式依赖管理:它能列出过时、未使用或缺失的依赖,并允许开发者通过交互界面一键升级或删除。但它对“未使用”的判断逻辑较简单,且已多年未更新。
# npm-check 基本用法
npx npm-check -u # 交互式更新/删除
⚠️ 注意:根据 npm-check 的 GitHub 仓库 和 npm 页面,该项目自 2018 年起已不再积极维护,官方 README 明确建议新项目考虑其他替代方案。因此,不推荐在新项目中使用
npm-check。
depcheck:专注、轻量、可扩展depcheck 默认支持常见 JS/TS 文件,并可通过 --parsers 和 --detectors 扩展支持 Webpack、Babel、ESLint 配置等。它不会误报动态导入(如 require(dynamicVar)),但会忽略无法静态分析的用法。
// .depcheckrc 配置示例
{
"ignores": ["@types/*", "typescript"],
"parsers": {
"*.vue": "vue"
}
}
运行后输出简洁:
Unused dependencies
* lodash
* moment
Unused devDependencies
* @types/jest
knip:全面、智能、上下文感知knip 不仅检查依赖是否被 import,还会结合项目配置(如 package.json 中的 bin、exports、workspaces)和构建工具(Vite、Next.js、Storybook 等)来判断依赖是否真正“无用”。例如,即使某个包未在源码中直接 import,但如果它被 Vite 插件使用,knip 也不会将其标记为未使用。
// knip.config.js 示例
export default {
ignore: ['eslint'],
workspaces: ['packages/*']
};
输出结构化,包含多个类别:
Unused dependencies
- lodash
Unlisted dependencies
- clsx (used in src/utils.ts but not in package.json)
Unused files
- src/old-component.tsx
npm-check:简单但粗糙npm-check 通过扫描文件中的字符串匹配(如 require('xxx') 或 import xxx)来判断依赖使用情况。这种方式容易产生误报(如注释中的字符串)或漏报(如模板字符串拼接的动态 require)。且不支持 TypeScript 或现代构建工具的上下文。
# 输出示例(交互式前)
npm-check
┌───────────────┬───────────┬───────────────────────┐
│ Package │ Type │ Used? │
├───────────────┼───────────┼───────────────────────┤
│ lodash │ UNMET │ NO │
└───────────────┴───────────┴───────────────────────┘
depcheck 配置简单,适合 CI 流水线中作为快速检查步骤。但功能较为单一,仅限依赖分析。
knip 提供丰富的配置选项和插件系统,可深度集成到大型项目中。支持生成修复建议(--fix 模式可自动删除未使用依赖),并能与 ESLint、TypeScript 编译器协同工作,提供更高精度。
# knip 支持自动修复(需确认)
npx knip --fix
npm-check 主要面向交互式使用,不适合自动化流程。其 -u 模式虽方便,但因维护停滞,与现代工具链(如 pnpm、Turborepo)兼容性差。
depcheck 足够胜任。knip 是目前最先进、最可靠的选择。npm-check。虽然它曾是早期流行工具,但缺乏维护和现代语言/工具支持,容易给出错误建议。| 特性 | depcheck | knip | npm-check |
|---|---|---|---|
| 主要用途 | 检测未使用依赖 | 全面项目健康检查 | 交互式依赖管理 |
| TypeScript 支持 | ✅(需配置) | ✅(原生支持) | ❌ |
| 构建工具上下文感知 | ❌ | ✅(Vite, Next, Storybook 等) | ❌ |
| 自动修复 | ❌ | ✅(--fix) | ✅(交互式) |
| Monorepo 支持 | ⚠️(需手动配置) | ✅(原生支持) | ❌ |
| 维护状态 | ✅(活跃) | ✅(非常活跃) | ❌(已停止维护) |
knip:它代表了下一代项目分析工具的方向——上下文感知、多维度检查、可修复。depcheck:如果你只需要一行命令确认是否有明显冗余依赖,它依然可靠。npm-check:技术债不应从第一天就开始积累。选择 knip 如果你在中大型项目(尤其是 Monorepo)中工作,使用了 Vite、Next.js、Storybook 等现代工具链,并希望获得高精度、上下文感知的全面项目健康报告。它不仅能检测未使用依赖,还能发现未使用文件、缺失依赖等问题,并支持自动修复,是当前最先进且活跃维护的选择。
选择 depcheck 如果你只需要一个轻量、快速的工具来检测项目中明显未被使用的 npm 依赖,且项目结构相对简单(如标准 React/Vue + TypeScript 项目)。它适合集成到 CI 流程中作为基础检查,但不提供自动修复或多维度分析能力。
不要在新项目中选择 npm-check。尽管它曾提供便捷的交互式依赖管理,但官方已明确停止维护多年,缺乏对 TypeScript、现代构建工具和包管理器(如 pnpm)的支持,容易产生误报或兼容性问题。应优先评估 knip 或 depcheck 作为替代方案。
Knip finds and fixes unused dependencies, exports and files in your JavaScript and TypeScript projects. Less code and dependencies lead to improved performance, less maintenance and easier refactorings.
Special thanks to the wonderful people who have contributed to Knip!
/'knɪp/ means "(to) cut" and is pronounced with a hard "K" 🇳🇱
Knip is free and open-source software licensed under the ISC License.
Parts of Knip have been inspired by and/or partially copy code from the following projects: