Unref: 基于Ruff解析器的Python死代码清理工具
Show HN: Unref – A Python dead code finder built on Ruff's parser

Unref是一款专为Python开发者打造的死代码检测工具,它利用Ruff的高效解析器精准识别项目中未被引用的代码。无论是冗余的函数、未使用的变量,还是过时的导入,Unref都能快速定位并提示清理。它支持Python 3.15及PEP 810等最新特性,帮助开发者保持代码库的整洁与高效。通过集成到CI/CD流程,Unref还能在PR阶段自动报告新增或移除的未引用代码,让团队协作更加顺畅。
用Ruff的解析器驱动,Unref让Python代码的‘瘦身’变得既精准又高效。
HN 评论区
17- selcuka
很酷的项目。在这个阶段,我认为误报比漏掉的死代码更重要。例如,它会将所有 Django 设置标记为未使用的变量,这可能是因为 Django 项目中通常不会直接导入设置。例如:
from django.conf import settings
...
if settings.DEBUG:
...
目前 unref 认为 DEBUG 没有被使用。
同样,asgi.py(或 wsgi.py)中的 `application` 变量是作为参数传递给 ASGI/WSGI 服务器可执行文件的,但它也被标记为未使用。
- peterabbitcook
你有没有把你构建的东西和 nuitka 的一些内部机制做过对比?nuitka 会在模块级别停止死代码搜索,但它们的排除/包含标志/规则可能会引导你在常见包上减少误报。
- athoscouto
我内部也在尝试做类似的事情。也是从 Python 开始,后来转到了 ruff。不过我的目标稍微广泛一些。我想利用依赖图来检测项目中发生变化的部分,从而选择性地触发镜像构建和运行测试。
结果仍然不太理想,特别是在测试方面。到目前为止,主要的经验是:一个整洁的代码库(依赖图)对于其正常运行至关重要。
我很惊讶没有发现更多开源工具能有效解决这个问题。