目前网上lerna的教程不是很清楚, 所以我自己整理并且实践的笔记
创建项目
$ mkdir lerna-repo && cd lerna-repo
$ npm init
// 本地目录安装
$ npm i lerna -D
$ npx lerna init
// or 全局安装
$ npm install --global lerna
$ lerna init目录结构
lerna-repo/
packages/
core/
utils/
package.json
lerna.json这里我们将项目分成2个子包, 后面会教大家创建
一个core子项目, 一个utils子项目
lerna create
创建子包
lerna create [loc(指定目录)]
// lerna create core
// lerna create utils lerna add
安装依赖
lerna add [@version] [--dev] [--exact] [--peer] 比如
lerna add fetch package目录下的子项目都会安装到
指定package安装(utils名称的子项目)
lerna add fetch packages/utils/命令
常用命令
lerna link
链接子包与子包之间的依赖(本地)
# core/ package.json
...
"dependencies": {
"fetch": "^1.1.0",
"@xxx/utils": "^1.0.4" // xxx为对应子包utils上面的package.json中的name
},
...接下来运行lerna link
node_modules添加的包地址指向本地子包utils
lerna run
运行包的命令
将core和utils的package.json修改
...
"scripts": {
"test": "echo \"Run test from utils\""
},
...运行lerna run test
echo "Run test from utils"
"Run test from utils"
lerna info run Ran npm script 'test' in '@xxx/core' in 0.9s:
> echo "Run test from core"
"Run test from core"指定运行
lerna run --scope @xxx/utils test
lerna clean
清空package子项目的node_modules
lerna bootstrap
安装package子项目的依赖(node_modules)
补充命令
lerna exec
执行命令行
# 删除所有子包中的node_modules
lerna exec -- rm -rf node_modules/
# 删除指定utils子包中的node_modules
lerna exec --scope @xxx/utils rm -rf node_modules/发布操作
git绑定远程仓库
npm login进行登录和创建Organization 仓库(Unlimited public packages)
lerna publish
发布一个版本
记得publish之前绑定远程仓库和npm的Organization
ps: 正常更新git push, 版本替换的时候才使用lerna publish
>lerna publish
lerna notice cli v4.0.0
lerna info current version 1.0.7
lerna info Looking for changed packages since v1.0.7
? Select a new version (currently 1.0.7) (Use arrow keys)
> Patch (1.0.8)
Minor (1.1.0)
Major (2.0.0)
Prepatch (1.0.8-alpha.0)
Preminor (1.1.0-alpha.0)
Premajor (2.0.0-alpha.0)
Custom Prerelease
Custom Versionlerna publish 选择Patch会更新的子包中的package.json的version更改为指定版本
lerna会自动生成git tag(版本标签)上传github上, 和自动上传npm的版本号(对应更新的子包)
lerna diff
查看包的本地修改
# core/ index.js
function core() {
// TODO
+ console.log("core")
}