我们通常通过 npm 来安装和使用开源的模块。但是,通常我们有些私有的模块,不想通过npm发布,但是又想在一些项目中共享使用,而且我们不想将公共模块是复制到各个项目中来使用。而且一旦公有模块更新,我们也不能及时更新。当然,如果不嫌麻烦,可以用相对目录,不过这种在开发代码时,引用时,写法上就要将相对目录写上。但是我们现在探讨的是另一种方式——利用现有的git,既不用搭建私有的npm私有仓库(npm private repository),又能满足上面的需求,它作为一个快速解决方案, 后期是可以慢慢过渡升级到使用完整 npm 私有仓库的解决方案的.
打造一个完整的 npm 私有仓库, 需要服务器, 需要安装环境。后面会有文章单独介绍。
新建 npm 私有模块
下面以一个实例来说明如何在 GitLab 中新建一个 npm 私有模块, 假设我们要新建的私有模块名为: wave-test
在 GitLab 上新建一个 project, 名字为: wave-test
对于公共模块, 最好是放在同一个 group 下, 例如放在 wavesnows 这个 group 下. 那么以后所有公共模块的 git 地址就可以统一为:
http://git.your-inc.com/{group}/{project}.git
将项目 clone 下来
git clone http://git.your-inc.com/wavesnows/wave-test.git
添加 package.json 配置, 注意限定 @scope
npm init --scope=wavesnows
然后提交 push 上去
到这里私有模块就已经发布好了, 如果有项目要使用, 就配置下项目的 dependencies 即可.
使用私有模块
添加私有模块的依赖
在项目的 package.json 中添加依赖, 例如: 依赖 @wavesnows/wave-test 这个私有模块
"@wavesnows/wave-test": "git+http://git.your-inc.com/wavesnows/wave-test.git"
如果想固定依赖某个分支,可以加上分支的名字,比如分支branch1,
"@wavesnows/wave-test": "git+http://git.your-inc.com/wavesnows/wave-test.git#branch1"
安装私有模块
跟安装开源的模块一样, 使用 npm install 安装依赖即可. 私有模块会安装在 @scope 的子文件夹中, 例如:
node_modules/@wavesnows/wave-test
代码中使用私有模块
- 跟使用开源的模块一样, 我们只要写对应的包名即可. 私有模块的包名只是带有 @scope而已.
var wave = require('@wavesnows/wave-test');// 另外一种引用方式import WT from '@wavesnows/wave-test'
- 如果在使用webpack的项目中使用,我们还可以通过配置alias来简化代码中的写法
alias: { 'wave-test': '@wavesnows/wave-test'}
在代码中就可以和引用其他module一样了
var wave = require('wave-test');// 或者import WT from 'wave-test'
如果alias中配置了
'@': resolve('src')
我们在使用带有scope的模块的时候,如果不配置alias,@可能会造成冲突,这个和webpack的ModuleAliasPlugin的实现有关。
'@': resolve('src'),'wave-test': resolve('node_modules/@waevsnows/wave-test'),// 或者'wave-test': '@wavesnows/wave-test',
更新私有模块
如果私有模块的版本更新了, 我们使用 npm update 是无法更新私有模块的, 只能通过
npm install @wavesnows/wave-test
这样的方式来重新安装一次私有模块, 才能获取到最新版本的私有模块.
私有模块的规范
- package.json#name 必须限定 @scope@scope 一般为 GitLab group 的名字, 例如 @companyfe, 那么 name 为: @wavesnows/wave-test
- package.json#private 设置为 true防止你一不小心将私有模块发布上去
{ "name": "@wavesnow/wave-test", "version": "0.0.1", "description": "Wave Tools", "main": "index.js", "private": "true", "repository": { "type": "git", "url": "http://git.your-inc.com/wavesnow/wave-test.git" }, "keywords": [ "wave", "git", "tool", "javescript" ], "author": "wavesnow", "license": "MIT"}