选择第三方 NPM 包时的 5 条最佳实践

2022-07-13 14:26:14 浏览数 (1)

每个开发人员都使用过 npm install 安装依赖。截止目前 NPM 平台上已经托管超过 190w 个包了,面对茫茫多的 package,在选择第三方 NPM 包时应该关注些什么?

这里为大家介绍 5 条最佳实践。

1. 检查开源许可证(License)

开源许可证是一种法律许可。通过它,版权拥有人明确允许,用户可以免费地使用、修改、共享版权软件。

版权法默认禁止共享,也就是说,没有许可证的软件,就等同于保留版权,虽然开源了,用户只能看看源码,不能用,一用就会侵犯版权。所以软件开源的话,必须明确地授予用户开源许可证。

可以在 NPM 平台上查看包的 License

License 通常分两大类:"CopyLeft(著佐权)" 和 "Permissive(宽松式)":

  • CopyLeft:如果你使用了这个包,那么你的代码也必须开源。这对一些商业化的项目不太友好,比如 GPL 和 LGPL 协议。
  • Permissive:对包做了最低限度的使用限制,允许闭源,可以说几乎没有限制,但是各自又有一些区别,具体见下图。

我们可以用 license-checker[1] 工具来一次性检查项目中的 NPM 包是否都是合规的。

2. 看贡献频率和下载量

NPM 平台也可以查看包的每周下载量和趋势图,数字越大意味着使用的人越多。

由于社区里有很多功能类似的包,比如 moment.jsdayjs 这类时间日期库。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 条最佳实践:

  • 检查开源许可证
  • 看贡献频率和下载量
  • 权衡包体积大小
  • 是否有大型开发团队在进行维护
  • 评估安全性

在做选择时,我们最好能根据以上维度产出一份调研文档,并在团队内分享和讨论,最终得出一致的结论。

参考

  • https://blog.bitsrc.io/5-best-practices-when-choosing-third-party-npm-packages-2198994357f9
  • https://blog.51cto.com/u_13859849/2140790
  • https://www.ruanyifeng.com/blog/2011/05/how_to_choose_free_software_licenses.html
  • https://www.runoob.com/w3cnote/open-source-license.html

谢谢支持❤️

如果觉得不错,就点赞在看分享吧,谢谢各位大佬啦~

参考资料

[1]

license-checker: https://www.npmjs.com/package/license-checker

[2]

NPM trends: https://www.npmtrends.com/

[3]

bundlephobia: https://bundlephobia.com/

[4]

npmgraph: https://npm.anvaka.com/

0 人点赞