您现在的位置是:首页 >技术教程 >前端:记录一次monorepo的改造过程网站首页技术教程
前端:记录一次monorepo的改造过程
itravel-web
使用 monorepo 管理项目
- admin
- web
amin
pnpm admin:dev
pnpm admin:build
web
pnpm web:dev
pnpm web:build
pnpm web:build:dev
pnpm monorepo 改造原有项目记录
解决方案
- 建立 monorepo 项目文件夹
- pnpm init 初始化项目
- 建立 packages 文件夹
- 建立 pnpm-workspace.yaml 文件,写入以下内容
packages:
- 'packages/**'
- 建立 .npmrc 文件,写入以下内容
shamefully-hoist=true
strict-peer-dependencies=false
ignore-workspace-root-check=true
-
将原有项目复制到 packages,删除原有项目的以下内容
a. .git
b. .husky
c. commitlint.config.js
d. .gitignore -
更改原有项目的 package.json,这一部分的功能是将原有的 git 提交策略删除,最后通过配置 monorepo 仓库的提交策略检查代码规范
a. 重命名项目名称 @itravel/web
b. 删除 prepare script
c. 删除 lint-staged script
d. 删除 lint-staged 字段属性
e. 删除依赖@commitlint/cli
,@commitlint/config-conventional
,husky
,lint-staged
-
git init monorepo 项目,将原有项目的 .gitignore 文件复制到根目录下
-
(可选择)增加 git 提交策略,commitlint 和 lint-staged
a. 在 monorepo 项目路径下安装 commitlint 和 lint-staged,-w 表示将依赖写入到根目录的 package.json 中pnpm add -D -w @commitlint/cli @commitlint/config-conventional husky lint-staged
b. 初始化 husky,出现 .husky 文件夹
npx husky install
c. 更新 monorepo 项目的 package.json
{ "scripts": { "prepare": "husky insall" } }
d. 将 commitlint 集成到 husky,这一部分是检查 commit 规范。配置 commitlint,根目录创建 commitlint-config.ts,写入以下内容
module.exports = { extends: ['@commitlint/config-conventional'], };
e. husky 回调 commitlint
shell 形式创建
npx husky add .husky/commit-msg "npx --no-install commitlint -e $HUSKY_GIT_PARAMS"
手动在 .husky 文件夹创建
commit-msg
,写入以下内容#!/bin/sh . "$(dirname "$0")/_/husky.sh" npx --no-install commitlint -e $HUSKY_GIT_PARAMS
f. 将 lint-staged 集成到 husky,这一部分是检查 git staged 缓存区代码的规范,配置 lint-staged,更新根目录的 package.json ,可根据自己的需求,增加写入以下内容
{ "scripts": { "lint-staged": "npx lint-staged" }, "lint-staged": { "*.{js,ts,jsx,tsx}": ["prettier --write", "eslint --fix"], "*.vue": ["stylelint --fix", "prettier --write", "eslint --fix"], "*.{scss,sass,less,css}": [ "stylelint --fix --custom-syntax postcss", "prettier --write" ] } }
g. husky 回调 lint-staged
shell 形式创建npx husky add .husky/pre-commit "npm run lint-staged"
手动形式创建,在.husky 文件夹中创建 pre-commit,写入以下内容
#!/bin/sh . "$(dirname "$0")/_/husky.sh" npm run lint-staged
-
更新根目录 package.json,加入快捷启动命令,便能在根目录下直接启动某一个项目,–filter | -F 表示对某一个项目生效
{
"scripts": {
"admin:dev": "pnpm --filter @itravel/admin dev",
"admin:build": "pnpm --filter @itravel/admin build",
"admin:build:dev": "pnpm --filter @itravel/admin build:dev",
"web:dev": "pnpm --filter @itravel/web dev",
"web:build": "pnpm --filter @itravel/web build",
"web:build:dev": "pnpm --filter @itravel/web build:dev"
}
}
现在一个带有 git 检测的 monorepo 项目就搭建完成了,更多的需求定义可以查看以下文章
- https://juejin.cn/post/7227352009800138789
- https://juejin.cn/post/7071992448511279141
- https://lyh543.github.io/posts/2022-04-18-migrate-npm-multirepo-to-pnpm-monorepo.html