一句话总结:判断一个开源项目值不值得用,别只看星标。我按六条硬指标过一遍:数字带时间戳、星标看增速、fork 比读使用方式、issue 配最近提交、README 有没有自划边界、许可证与最小示例。最后那条最容易被跳过,也最容易出事。
先讲个刚发生的事。 两个多小时前,我核一个抓包扩展的数据:123 星、40 个 fork。写这篇时再查一次,125 星、40 个 fork。同一个仓库,同一天,数字变了两个。
这不是异常,是常态。所以第一条指标就一句:任何数字都要带上查询时间。 下面六条,是这半个月连着写十几篇评测攒下来的。每条都配了我自己踩到的反例,篇号是站内文章。
指标一:数字必须带时间戳
星标是活数。写进文章里的每一个,都得标「查询于某日」。 理由有两个。一是读者能判断这个数字还成不成立;二是你自己过两个月回头看,知道该不该重核。
我早期吃过亏:一篇稿子里写「1,368 星」,其实是把别处的数字抄串了,后来对着接口重核才发现应该是另一个量级。那次之后,我养成了「写数字先跑接口」的习惯。
接口返回的还有创建时间、最近提交时间、语言、仓库体积。这几项比星标更能说明项目处在什么阶段。
指标二:星标看增速,不看总量
一个项目三万星、但创建三年,和一个项目两千星、创建两个月,后者更值得关注。
站上那篇同名仓库的调查就是反例。我查了三十五个同名仓库,星标都卡在四百七十左右,没有一个跑出来。这说明这个赛道的需求没有被哪个仓库接住,星标分布本身就是信号。
具体算法很简单:用星标除以创建至今的月数,得到一个「月均」数。这个数过了五百,说明它在当下有真实拉力。 要注意的是别把这个数当质量分。刷星的项目也有月均很高的,所以还得往下看。
指标三:fork 比能读出使用方式
用 fork 数除以星标数,这个比例比单独看任何一个都信息量大。 我核过的几个样本:光猫凭据脚本 22.7%,说明拿到就要改着跑;去 AI 味的提示词包 7.8%,装完就用,很少有人改;Blender 插件 1.0%,发的是编译好的压缩包,用户没有改源码的动机。
所以这个比例回答的是「用户怎么用它」,不是「它好不好」。 低比例配上高星标,通常意味着它是成品工具;高比例配上低星标,通常意味着它是半成品脚本,需要你动手。
指标四:issue 数要配最近提交时间看
四百多个待处理 issue 听着吓人。但如果最近一次提交在三天内,说明有人在接。 反过来,一个只有两个 issue、但半年没提交的项目,更像已经停摆。
我核过的抓包扩展是 1 个 issue、最近提交在创建后两天,之后就安静了。这个组合的意思是:功能能用,但别指望长期维护。
还有一个细节值得看:issue 的内容类型。全是「装不上、连不上」的,说明文档和兼容性有问题;全是功能请求的,说明基础功能已经稳了。
指标五:README 敢不敢自划边界
这是我用得最顺的一条,而且特别反直觉。 敢在 README 里写「这个功能做不到」的项目,可信度明显高于通篇吹的。
两个例子。Blender 那个插件自己写:Python 校验有帮助,但它不是安全沙箱。去 AI 味那个项目自己写:它不试图骗过检测器,检测器仍然会标出它的大部分输出。
这两句都是在削弱自己的卖点。愿意这么写的作者,通常也会在别的地方说实话。 反过来的信号也要记:满篇最高级形容词、没有一条限制、把「安全」当卖点却不说明权限模型的,我一般直接跳过。
指标六:许可证和最小示例
许可证这条最容易被跳过,后患也最大。
MIT 基本不设限;AGPL 就不同,把改过的版本当网络服务提供时,要公开源码。抓包扩展那篇里我提过这一点,它的许可证是 AGPL-3.0,想内网部署改过的版本就得先看清这条。
最小示例指的是:README 里有没有一段能直接跑起来的东西。命令、参数、预期输出,三样都在,才是能验证的。
我自己写四十行客户端那篇时,就是按这个标准来的:代码贴全,参数标清,跑出来的结果写出来。读者照抄能跑通,这篇才算有交付。

图 1:前三条看数据,后三条看作者态度
三条我自己也在犯的错
第一条:先有结论再找证据。看到一个项目觉得有意思,就只挑对它有利的数字写。这种稿子读者未必察觉得到,但自己心里清楚。
第二条:把「活跃」当「好用」。提交频繁的仓库也可能方向一直在变,上个版本能跑的东西下个版本就没了。 第三条:忽略自己没验证的部分。我现在固定在文末写「口径与核验」,把没实测的东西标出来。这条规矩不是为了自保,是为了让读者能区分「我查到的」和「我猜的」。
FAQ
Q:星标多少算够?
没有绝对数。我的经验是:两百星以下要看是否有活跃维护,一千星以上可以直接试。
Q:fork 比多少算正常?
看形态。成品工具 1% 到 8%,脚本类 10% 到 30%,都正常。
Q:没许可证的项目能用吗?
自己看代码学习可以,商用要谨慎。没有许可证默认保留所有权利,不是「随便用」。
参考资料
- GitHub REST API · Repositories(星标、fork、提交时间等字段的来源)
- Open Source Initiative · Licenses(许可证条款对照)
口径与核验:文中提到的抓包扩展 125 星、40 fork、1 个 issue,和去 AI 味项目 71,926 星、5,629 fork,都是本文写作当天从 GitHub 接口现查的;其余比例(22.7%、7.8%、1.0%)是我用当时查到的一对数算的,四舍五入到一位小数。六条指标的排序是我的个人偏好,没有做过对照实验,不能证明按这六条筛出来的项目一定好用。
- FAQ
- 参考资料
发表评论
◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。