二,pnpm-workspace环境搭建
2.1,创建monorepo
项目目录。
终端内:
// 创建目录 mkdir monorepo-pnpm-workspace-base // 进入项目 cd monorepo-pnpm-workspace-base
复制
2.2,初始化项目:
pnpm init
复制
2.3,package.json
删除 main、test
去掉后
2.4,创建 pnpm-workspace.yaml
文件
这个文件定义了工作空间的根目录。
packages: # all packages in direct subdirs of packages/ - 'packages/*' # all packages in subdirs of components/ - 'common/**' # exclude packages that are inside test directories - '!**/test/**'
复制
2.5,创建目录common、packages
mkdir common && mkdir packages
复制
2.6,package.json文件内增加"private": true,以表示该项目是私有的。
2.7,进入packages
创建多个项目
cd packages
复制
pnpm create vite app-base --template vue-ts
复制
pnpm create vite app1 --template vue-ts
复制
pnpm create vite app2 --template vue-ts
复制
2.8,根目录下package.json增加如下红框内容。
2.9,写packages
下每个项目的package.json
。主要是name
字段,方便以后使用。
packages目录下app-base、app1、app2的package.json删除如下图红框内容
2.10,在整个项目根目录下(monorepo-pnpm-workspace-base)安装依赖。——> 所有工作空间安装依赖:在根目录下运行pnpm install命令,它会自动安装所有子项目的依赖。
pnpm i
复制
如果在根目录下安装依赖的话,这个依赖可以在所有的packages中使用。如果需要为具体的一个package安装依赖,如何处理?
pnpm 提供了 --filter 参数。
-
给某个子项目单独安装指定依赖
pnpm add axios --filter app2
复制
-
模块之间的相互依赖
pnpm install dayjs --filter app2
复制
上面命令表明:在@commom/components
中安装dayjs
。其中--filter
过滤包名,具体使用可以参考pnpm --filter。
在设置依赖版本的时候推荐用 workspace:* ,这样就可以保持依赖的版本是工作空间里最新版本,不需要每次手动更新依赖版本。
2.11,app-base、app1、app2分别在vite.config.ts中设置端口号
server: { port: 5173 }
复制
2.12,根项目package.json配置
2.13,启动项目
pnpm run dev-base
复制
启动成功,同理启动 app1、app2
三、pnpm公共组件库
3.1,创建common目录及文件如下
3.2,common/components/snow/index.vue
<template> <div>snow components index</div> </template> <script setup lang="ts"> </script> <style scoped> </style>
复制
3.3,common/components/index.js
export * from "./snow"
复制
3.4,common/components/package.json
{ "name": "@common/components", "version": "1.0.0", "description": "pnpm-workspace-common-components", "private": true, "keywords": [], "author": "", "license": "MIT", "main": "index.ts" }
复制
3.5, 安装workspace依赖
下边命令式packages下所有项目都安装,也可以指定项目安装见2.10
pnpm i @common/components -w
复制
package.json 增加内容如下
3.6,app-base/src/App.vue引入使用组件snow
3.7,启动项目 pnpm run dev-base,运行成功,组件内容已使用成功。
3.8,指定项目按照common下依赖
pnpm i @common/components --filter app-base
复制
安装后package.json增加依赖,子项目node_modules增加依赖,同样运行成功。
四、app-base项目
中引用common/components/组件或方法
首先,在common/components
/index.js
中export
一个格式化日期函数,代码如下:
import dayjs from 'dayjs' export function formatDate(value, format = 'YYYY-MM-DD') { return dayjs(value).format(format) }
复制
然后执行如下命令:
pnpm -F @packages/app-base install @common/components
复制
-F等价于–filter
这个命令表示在@packages/app-base
安装@common/components
。