选择 npm 包时避免踩坑的五条建议
2022-04-19 16:28:28来源:小李的前端小屋
每个开发人员都使用过npm install安装依赖。截止目前 NPM 平台上已经托管超过 190w 个包了,面对茫茫多的 package,在选择第三方 NPM 包时应该关注些什么?
这里为大家介绍 五 条建议。
1. 检查开源许可证(License)开源许可证是一种法律许可。通过它,版权拥有人明确允许,用户可以免费地使用、修改、共享版权软件。
版权法默认禁止共享,也就是说,没有许可证的软件,就等同于保留版权,虽然开源了,用户只能看看源码,不能用,一用就会侵犯版权。所以软件开源的话,必须明确地授予用户开源许可证。
可以在 NPM 平台上查看包的 License
License 通常分两大类:"CopyLeft(著佐权)" 和 "Permissive(宽松式)":
CopyLeft:如果你使用了这个包,那么你的代码也必须开源。这对一些商业化的项目不太友好,比如 GPL 和 LGPL 协议。Permissive:对包做了最低限度的使用限制,允许闭源,可以说几乎没有限制,但是各自又有一些区别,具体见下图。我们可以用license-checker[1]工具来一次性检查项目中的 NPM 包是否都是合规的。
2. 看贡献频率和下载量NPM 平台也可以查看包的每周下载量和趋势图,数字越大意味着使用的人越多。
由于社区里有很多功能类似的包,比如moment.js和dayjs这类时间日期库。NPM trends[2]可以同时比较多个包的下载量增长趋势,从而更直观地了解它们的受欢迎程度。
另外,GitHub 仓库的 stars、 forks、 commit frequency 和 contributors 等相关指标也可以侧面反映受欢迎程度。
3. 权衡包体积大小对于前端来说,优化性能最直接的手段就是降低代码包大小。所以选择第三方包时,也要考虑它的包体积。
bundlephobia[3]可以对包体积进行可视化分析。从下图可以看出,moment.js打包后会有将近 300 kB,gzip 压缩后会有 70kB。
而dayjs打包后只有6 kB,远小于moment.js。
对于像微信小程序这样对代码包大小有明确限制的项目来说,轻量级的dayjs是更好的选择。
4. 是否有大型团队在进行维护尽管大部分的 NPM 包都包含较全的文档,但是往往也都存在一些兼容性、JS 异常或性能相关的 issue。因此如果背后有大型团队在进行维护,我们使用起来会更放心。
可以关注以下几个方面:
Used By 和 Contributors 数量数量越多意味着你不是早期用户,很多开发者已经帮你趟过水了。
Contributors 视图可以直观地看到贡献者的贡献频率,如果很多都频繁贡献,意味着仓库受到社区更多的关注和支持。
Community Standards将仓库与开源社区的规范标准进行比较,达到的标准越多意味着这个仓库越成熟。
5. 评估安全性包安全性是选择 NPM 包的另一个关键因素,在仓库的「Security」tab 下可以看到它的安全策略。
如果维护者已经采取了措施来确保安全性,会显示已激活。
对于项目中已有的 NPM 依赖,可以使用命令npm audit来进行安全性检查。
npmgraph[4]能够对包进行依赖可视化分析来确保没有安全漏洞,然后再安装到项目当中。
总结回顾一下选择第三方 NPM 包的 5 条最佳实践:
检查开源许可证看贡献频率和下载量权衡包体积大小是否有大型开发团队在进行维护评估安全性在做选择时,我们最好能根据以上维度产出一份调研文档,并在团队内分享和讨论,最终得出一致的结论。