死代码检测工具对比:按语言选最好的(2026)

Raghav Chamadiya更新于 10 分钟
Compared in this post: repowise and
  • Knip
  • Vulture
  • ts-prune
本页目录

选死代码检测工具先看语言:JS/TS 用 Knip,Python 用 Vulture,Go 用官方的 deadcode 命令,Rust 用编译器自带的 lint,Java 和 C# 用 IDE 检查和 PMD 规则。 如果仓库混用多种语言,repowise dead-code 会在一张依赖图上一次报告未使用的文件、导出和包。无论用哪个,输出都只是候选项:先删置信度最高的。

语言首选值得了解未使用的依赖
PythonVulturedeadcode(支持 --fix)deptry
JavaScript / TypeScriptKnipts-prune(仅导出)Knip 自带
Godeadcodestaticcheck U1000go mod tidy
JavaIntelliJ "Unused declaration"PMD Unused* 规则mvn dependency:analyze; Gradle Dependency Analysis Plugin
C#Roslyn IDE0051 / IDE0052Rider 与 ReSharper 检查无内置
Rust编译器的 dead_code lintcargo-machete、cargo-udeps
多语言仓库repowise dead-code上面各语言的工具monorepo 中未使用的包

Scroll the table sideways to see every column.

除 repowise 的托管面板外,本文的工具都免费开源。以下信息来自各项目自己的文档,查阅于 2026 年 10 月。

We build repowise, so weigh our entry accordingly. The measurements we publish about it, with their methods, are on the benchmarks page.

我们如何评估

我们从团队实际会感受到的四个方面比较:

  • 能找什么: 未使用的文件、导出和成员、依赖,或其中几项。
  • 如何判断: 是否识别入口、有没有框架插件、是否给出置信度。
  • 如何落地: 能否放进 CI、有没有自动修复、如何处理已知误报。
  • 覆盖范围: 单一语言还是整个仓库。

什么算死代码

死代码是任何入口都到达不了的有效代码。 它分三种,需要不同的检查,所以很少有一个工具全部覆盖。

  • 未使用的文件: 没有文件 import 它,它也不是入口。只有项目级的依赖图才能看出来,逐文件阅读的工具做不到。
  • 未使用的导出: 其他文件从不 import 的函数、类、类型或常量。这是最容易入手的地方。
  • 僵尸包和未使用的依赖: 仍留在 package.json、requirements.txt 或 Cargo.toml 里、代码却不再使用的条目。它们增加构建时间和安全面,也让升级更嘈杂。

Python:Vulture 与 deadcode

Vulture 是 Python 死代码检测的标准工具。 它遍历 AST,找出未使用的类、函数、方法、变量、import、属性和不可达代码。2.16 版于 2026 年 3 月发布,需要 Python 3.9 或更高(PyPI)。

每条结果都带置信度:未使用的参数和不可达代码为 100%,import 为 90%,可能被动态代码用到的函数、类、属性和变量为 60%。--min-confidence 80 可以隐藏噪音较多的一档,--make-whitelist 会把当前的误报记录下来,下次运行只显示新增项。

bash
pip install vulture
vulture src/ --min-confidence 80

适合选 Vulture 的情况: 想要一个轻量、能放进 CI、并自带误报管理方式的 Python 检查。装饰器和框架的"魔法"(Django 视图、FastAPI 路由、Celery 任务、pytest fixture)是它常见的误报来源,把它们加入白名单即可。

deadcode(GitHub)是较新的选择,做 Ruff 和 flake8 不做的整库检查。它按 DCxxx 编码报告未使用的变量、函数、类、import、空文件和不可达代码块,deadcode . --fix 会直接删除,--fix --dry 先显示 diff。每次都先用 --dry,因为自动修复的好坏取决于它对入口的理解。

包的问题交给 deptry:它报告缺失(DEP001)、未使用(DEP002)和放错位置的开发依赖(DEP004),支持 pip、Poetry、PDM、uv 和 PEP 621。

JavaScript 与 TypeScript:Knip

Knip 是 JavaScript 和 TypeScript 最强的开源选择。 它一次找出未使用的文件、导出和依赖,200 多个插件让它了解 Next.js、Vite、Vitest、Jest、ESLint、Nx、Storybook、GitHub Actions 等的入口(knip.dev)。它支持 monorepo 和 workspace,准备好之后还能自动修复。

bash
npx knip                 # 未使用的文件、导出、依赖
npx knip --production    # 只看生产入口可达的代码

任何聪明的分析器都有同样的代价:入口文件要配对。漏掉一个,Knip 会把在用的代码报成未使用;入口配得太宽,又会藏起真正的死代码(配置项目文件)。

适合选 Knip 的情况: 项目是 JavaScript 或 TypeScript,希望一个工具同时管文件、导出和依赖。

ts-prune 只根据 tsconfig 打印未使用的导出。它的 README 写道项目"在长期停滞后被重新启用",因为许多项目依赖它,所以要保持可用(GitHub)。只要导出清单时它够用;新项目里 Knip 做同样的事,还多出文件和依赖。

Go:deadcode 与 staticcheck

官方的 deadcode 命令会报告从 main 出发任何执行路径都到不了的函数。 Go 团队在 2023 年 12 月推出,使用 Rapid Type Analysis,覆盖直接调用和接口调用(go.dev)。

bash
go install golang.org/x/tools/cmd/deadcode@latest
deadcode ./...
deadcode -test ./...    # 把测试当作入口,适用于库

它需要 main 入口,所以库要加 -test;只被汇编或 go:linkname 引用的函数它看不到。staticcheck 的 U1000 按包报告未使用的函数、类型、字段和常量,把导出名视为已使用,并作为 unused linter 在 golangci-lint 中运行。

适合两个都用的情况: 维护 Go 服务时,CI 里跑 U1000 看包级视图,偶尔跑 deadcode 看整个程序。未使用的模块交给 go mod tidy。

Java 与 C#:IDE 检查与分析器

Java 没有统一的整程序死代码命令行工具,团队通常把 IDE 检查和 CI 规则组合起来用。

  • IntelliJ 的 "Unused declaration" 检查适合在整个项目范围内运行,并配置好框架的入口注解(Spring、JAX-RS、测试框架)(JetBrains)。
  • PMD 的 UnusedPrivateMethod、UnusedPrivateField、UnusedLocalVariable、UnusedFormalParameter 和 UnusedAssignment 规则可在每次构建中运行。它们只覆盖私有和局部代码,所以强制执行也安全(PMD)。

反射、依赖注入和序列化是常见的误报来源,信任列表之前先声明你的注解。

C# 先用 SDK 自带的分析器。 IDE0051 标记未使用的私有成员,IDE0052 标记只写不读的私有成员(Microsoft Learn)。在 .editorconfig 里把两者设为 warning。未使用的 public 和 internal 代码需要用 Rider 或 ReSharper 做整个解决方案的检查。

Rust:编译器与 cargo-machete

Rust 在编译时就会报告未使用的私有项。 dead_code lint 默认开启。依赖方面,cargo-machete 扫描源码,找出 Cargo.toml 里没人引用的 crate,速度快,但按它自己的说法不够精确;cargo-udeps 根据编译器输出给出精确结果,需要 nightly 工具链。常见做法是 CI 里用 cargo-machete,偶尔跑 cargo-udeps。

未使用的依赖

未使用的依赖就是清单里的死代码。 它仍会被安装、扫描和升级。

生态工具报告内容
JS / TSKnip未使用和未声明的依赖,以及文件和导出
JS / TSdepcheck未使用的依赖;其 README 说明已不再维护,并推荐 Knip
Pythondeptry缺失、未使用和放错位置的开发依赖
Rustcargo-machete、cargo-udeps未使用的 crate
Gogo mod tidy移除没人 import 的模块

Scroll the table sideways to see every column.

如果 CI 里还在跑 depcheck,换成 Knip 很划算。

多语言仓库:repowise dead-code

repowise dead-code 在一张依赖图上,一次报告整个仓库所有语言中未使用的文件、导出和包。 上面每个工具都止步于自己的语言边界,这对单语言仓库没问题,但对 TypeScript 前端、Python 服务加共享包的仓库就是缺口。repowise 把 28 种语言解析进同一张图,一份报告就能覆盖全部。

每条结果按 0.0 到 1.0 打分,分为高(0.7 及以上)、中、低三档,并附上依据。未使用的文件根据 git 活动打分:一年没动的文件从 1.00 起算,仍在提交的从 0.40 起算。只有得分达到 0.7 且路径没有运行时加载风险,结果才会被标为可删除。分析只用图遍历加 git 历史:不需要 LLM 密钥,也不发起网络请求(文档)。

bash
uv tool install repowise
repowise init
repowise dead-code --safe-only
text
 Kind              File / Symbol            Confidence  Ready?  Lines  Reason
 unused_export     formatLegacyDate               100%    ✓       14  Public symbol 'formatLegacyDate' has no importers
 unreachable_file  src/legacy/parser.ts           100%    ✗      212  File has no importers (in_degree=0)

同样的结果可以通过 get_dead_code 工具交给编程智能体,它是 repowise 的 ten 个 MCP 工具之一,也出现在面板的 Dead code 视图里,每条结果都有处理状态。在 workspace 中,每条结果还会对照跨仓库数据检查,所以被其他仓库依赖的文件会降低置信度。repowise 以 AGPL-3.0 开源,可自托管。

repowise 仓库的架构图,工具栏里 All、Hot 旁边有 Dead 筛选
repowise 仓库的架构图。Dead 筛选会把死代码分析标出的文件,连同导入它们的文件一起显示出来。

适合选 repowise 的情况: 仓库跨多种语言,想要结合 git 的置信度,或者希望把结果共享给智能体和评审者。CI 里仍可保留 Knip 或 Vulture,用它们对框架更深的理解。想在真实代码库上看效果,可以打开 FastAPI 架构图,或浏览在线示例。

并排对比

工具语言未使用的导出 / 成员未使用的文件未使用的依赖自动修复
VulturePython有,带置信度否否否
deadcodePython有空文件否有(--fix)
deptryPython否否有否
KnipJS / TS有有有有
ts-pruneTS仅导出否否否
deadcodeGo不可达函数否否否
staticcheck U1000Go有否否否
PMD Unused* 规则Java仅私有和局部否否否
IntelliJ 检查Java、Kotlin有部分否快速修复
Roslyn IDE0051/52C#私有成员否否代码修复
repowise dead-code28 种语言有,分档有未使用的包否

Scroll the table sideways to see every column.

如何选择

  • 单语言仓库: 在 CI 里运行该语言的工具,并为已知例外加白名单或基线。
  • 多语言仓库或 monorepo: 用 repowise 看跨语言全貌,同时保留各语言工具的框架知识。
  • 对外发布的库: 导出在仓库内没有 importer。给它们加标记(Knip 里用 @public),删之前先查依赖方。
  • 集中清理: 先选一种信号,先删高置信度的叶子代码,用小补丁逐步移除。查找死代码指南在真实仓库上走了一遍。

常见问题

什么是死代码分析?
死代码分析找出永远不会运行或从未被使用的代码:不可达的函数、未使用的导出、没人 import 的文件和没人引用的依赖。静态工具从入口出发构建图;运行时工具(如生产环境的覆盖率)则找出可达但从未被调用的代码。
Python 最好的死代码检测工具是什么?
Vulture 是标准起点,带置信度和处理误报的白名单文件。deadcode 还能用 --fix 直接删除,deptry 负责未使用的包。
JavaScript 和 TypeScript 最好的死代码检测工具是什么?
Knip。它一次找出未使用的文件、导出和依赖,支持 monorepo,并为大多数框架提供插件。
ts-prune 已经废弃了吗?
没有。它的 README 说项目在长期停滞后被重新启用,因为许多项目依赖它,所以会保持可用。新项目用 Knip,除了导出还能覆盖文件和依赖。
如何找出未使用的依赖?
JavaScript 和 TypeScript 用 Knip,Python 用 deptry,Rust 用 cargo-machete 或 cargo-udeps,Go 用 go mod tidy。新项目不要用 depcheck,它的维护者说已不再维护。
如何在多种语言的仓库里找死代码?
用能解析所有这些语言的图工具。repowise dead-code 在一张依赖图上报告未使用的文件、导出和包,并给每条结果按置信度分档。
删除死代码工具报告的内容安全吗?
跑完整套测试后先删置信度最高的,其余的再人工审查。静态工具看不到通过字符串、反射或外部调用方加载的代码,所以动态加载器附近的文件和已发布库的导出要人工检查。 决定先清理什么,见按投入产出比排定技术债优先级。

索引你的仓库,免费