本页目录
选死代码检测工具先看语言:JS/TS 用 Knip,Python 用 Vulture,Go 用官方的 deadcode 命令,Rust 用编译器自带的 lint,Java 和 C# 用 IDE 检查和 PMD 规则。 如果仓库混用多种语言,repowise dead-code 会在一张依赖图上一次报告未使用的文件、导出和包。无论用哪个,输出都只是候选项:先删置信度最高的。
| 语言 | 首选 | 值得了解 | 未使用的依赖 |
|---|---|---|---|
| Python | Vulture | deadcode(支持 --fix) | deptry |
| JavaScript / TypeScript | Knip | ts-prune(仅导出) | Knip 自带 |
| Go | deadcode | staticcheck U1000 | go mod tidy |
| Java | IntelliJ "Unused declaration" | PMD Unused* 规则 | mvn dependency:analyze; Gradle Dependency Analysis Plugin |
| C# | Roslyn IDE0051 / IDE0052 | Rider 与 ReSharper 检查 | 无内置 |
| Rust | 编译器的 dead_code lint | cargo-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 会把当前的误报记录下来,下次运行只显示新增项。
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,准备好之后还能自动修复。
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)。
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 / TS | Knip | 未使用和未声明的依赖,以及文件和导出 |
| JS / TS | depcheck | 未使用的依赖;其 README 说明已不再维护,并推荐 Knip |
| Python | deptry | 缺失、未使用和放错位置的开发依赖 |
| Rust | cargo-machete、cargo-udeps | 未使用的 crate |
| Go | go 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 密钥,也不发起网络请求(文档)。
uv tool install repowise
repowise init
repowise dead-code --safe-only
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 的情况: 仓库跨多种语言,想要结合 git 的置信度,或者希望把结果共享给智能体和评审者。CI 里仍可保留 Knip 或 Vulture,用它们对框架更深的理解。想在真实代码库上看效果,可以打开 FastAPI 架构图,或浏览在线示例。
并排对比
| 工具 | 语言 | 未使用的导出 / 成员 | 未使用的文件 | 未使用的依赖 | 自动修复 |
|---|---|---|---|---|---|
| Vulture | Python | 有,带置信度 | 否 | 否 | 否 |
| deadcode | Python | 有 | 空文件 | 否 | 有(--fix) |
| deptry | Python | 否 | 否 | 有 | 否 |
| Knip | JS / TS | 有 | 有 | 有 | 有 |
| ts-prune | TS | 仅导出 | 否 | 否 | 否 |
deadcode | Go | 不可达函数 | 否 | 否 | 否 |
| staticcheck U1000 | Go | 有 | 否 | 否 | 否 |
| PMD Unused* 规则 | Java | 仅私有和局部 | 否 | 否 | 否 |
| IntelliJ 检查 | Java、Kotlin | 有 | 部分 | 否 | 快速修复 |
| Roslyn IDE0051/52 | C# | 私有成员 | 否 | 否 | 代码修复 |
repowise dead-code | 28 种语言 | 有,分档 | 有 | 未使用的包 | 否 |
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在一张依赖图上报告未使用的文件、导出和包,并给每条结果按置信度分档。 - 删除死代码工具报告的内容安全吗?
- 跑完整套测试后先删置信度最高的,其余的再人工审查。静态工具看不到通过字符串、反射或外部调用方加载的代码,所以动态加载器附近的文件和已发布库的导出要人工检查。 决定先清理什么,见按投入产出比排定技术债优先级。


