pnpm-workspace环境搭建

二,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.jsexport一个格式化日期函数,代码如下:

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

### 关于 `pnpm test` 无法调用 Vitest 的问题 当遇到 `pnpm test` 无法调用 Vitest 的情况时,可能的原因涉及多个方面,包括脚本定义、工作区配置以及工具链设置等。以下是详细的分析和解决方案: #### 脚本一致性检查 在 monorepo 中,通常会在根项目的 `package.json` 文件中定义通用的脚本命令。如果希望 `pnpm test` 命令能够触发 Vitest,则需要确保该脚本被正确定义。例如,在根目录下的 `package.json` 文件中应有如下内容[^3]: ```json { "scripts": { "test": "vitest" } } ``` 如果没有正确定义上述脚本,那么运行 `pnpm test` 将不会调用到 Vitest。 --- #### 多线程支持与性能优化 默认情况下,Vitest 支持多线程并发执行测试案例以提升效率。然而,某些场景下可能会因环境限制而禁用了这一特性。这可能导致部分功能未能正常启动或表现异常。因此需要注意以下事项[^4]: - 如果显式设置了单线程模式(通过 CLI 参数如 `--threads=false`),则需重新评估是否必要; - 推荐保持启用多线程选项以便充分利用硬件资源加快测试进程。 --- #### 配置 pnpm 工作区 对于采用 pnpm 构建的工作区而言,其核心配置文件为 `pnpm-workspace.yaml` 。此文件决定了哪些路径会被识别成独立模块并纳入整体构建流程之中[^2]。假设当前项目结构如下所示: ``` my-monorepo/ ├── packages/ │ ├── package-a/ │ └── package-b/ └── pnpm-workspace.yaml ``` 此时应在 `pnpm-workspace.yaml` 内指定相关子包所在位置: ```yaml packages: - 'packages/*' ``` 只有这样,才能让各个组件间共享依赖关系的同时也允许统一操作诸如安装依赖项或是运行全局性的任务比如单元测验等活动。 --- #### 使用 Vitest 提供的功能扩展 除了基本命令外,还可以借助额外手段增强用户体验。例如利用图形化界面来进行更直观的操作[^5]: ```bash npx vitest --ui ``` 这种方式特别适合团队协作开发阶段,因为它提供了实时反馈机制帮助开发者快速定位失败原因。 综上所述,要解决 `pnpm test` 不调用 Vitest 的问题,可以从以下几个角度入手:确认根级 `package.json` 是否含有恰当的任务描述;核查是否存在影响程序行为的关键参数设定;最后还要保证整个生态系统按照预期搭建完毕无误。 --- ### 示例代码片段 下面给出一段简单的例子展示如何在一个典型的 monorepo 设置里实现自动化测试过程。 ```javascript // Root level package.json script section "scripts": { "test": "vitest run", } // Example of running tests across all relevant sub-packages via recursive invocation pattern. pnpm -r exec vitest run ```
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值