前言
在前端开发过程中,我们经常会使用到各种别人开发的npm包,这些包在代码中的引用方式一般有两种,一种是我们比较熟悉的直接使用包名引用,例如
import axios from 'axios';
另一种则是通过git地址引用,例如
npm install git+https://github.com/axios/axios.git
前者常常可以直接使用,但后者却经常会遇到各种问题,特别是在小团队中,每个人的git clone路径不一致时,甚至会导致编译不过的情况。
由此,本文介绍一个npm 包 gitlink,它提供了方便简单的设置方式,可以让我们通过git地址来引用npm包。并不会在npm仓库中保存这些基本库,而是通过git克隆来安装它们。这使得它成为了一个强大的工具,尤其是对于需要维护一些私有的npm包的项目,非常实用。
安装
使用 npm 安装:
npm install -g gitlink
使用方法
- 在 package.json 中配置 gitlink
在发布后的 npm 包中的 package.json 中,我们需要添加一个 gitlink 字段。值为一个包含 git 地址的对象,例如:
-- -------------------- ---- ------- - ------- ---------- ---------- -------- -------------- ---------- ------- ----------- ---------- - -------- ------------------------------------ - -
在这个例子中,我们将 url git 链接指向 axios 的 repo。
- 安装 gitlink 依赖项
npm install gitlink --save-dev
或者你可能想在全局下安装它:
npm install -g gitlink
- 运行 gitlink
gitlink
简单到这里,运行 gitlink 就会自动从 git 克隆 repository 和安装依赖项。
- 引入 git 地址
在需要使用 git 作为依赖项的项目中,告诉 npm,我们要使用 gitlink 来安装包,我们可以这样来 set url 依赖项。
npm install gitlink@git@[remote-url-to-repo]/[repo-name] --save-dev
其中,[remote-url-to-repo] 是你的 repo 的远程地址。
示例代码
这里是一个示例代码的 package.json 文件中,假设我们维护了一个私有的 npm 包 whisly。我们将 whisly 作为依赖项导入到我们的示例项目中,这个包的 git 地址为: https://github.com/some-company/whisly.git
-- -------------------- ---- ------- - ------- ---------- ---------- -------- -------------- ---------- ------- ----------- ---------- ------ --------------- --- ------------------ - ---------- --------- ----------------------- ---------------------------------------- -- ---------- - --------- -------------------------------------------- - -
接下来,我们只需要运行 gitlink 就可以安装 whisly 和他的所有所需的依赖项。
gitlink
总结
通过使用 gitlink,我们可以方便的从 git 加载依赖项,而无需手动 git clone 或设置 PATH 等。这个工具对于开发团队维护私有 npm 包的项目非常实用。希望本篇文章的内容能给你带来指导意义,感谢阅读!
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055cb581e8991b448da2a5