引言：为何选择pnpm+monorepo？

在大型前端或全栈项目中，随着子项目数量的增加，依赖管理和代码复用成为两大挑战。传统方式下，每个项目独立安装依赖，不仅占用大量存储空间，还可能因版本不一致导致难以调试的兼容性问题。而monorepo（单一仓库多项目）模式，通过将所有相关项目集中在一个仓库中管理，结合pnpm（一个快速、节省磁盘空间的Node.js包管理器）的独特优势，能有效解决这些问题。

pnpm通过硬链接和符号链接技术，实现了依赖的共享与隔离，既减少了磁盘占用，又保证了各项目间依赖的独立性。同时，monorepo架构促进了代码的复用与模块化，提升了开发效率与团队协作的便捷性。本文将引导您在几分钟内完成pnpm+monorepo工作空间的搭建。

准备工作

在开始之前，请确保您的系统已安装Node.js（建议版本14+）和npm/yarn。pnpm可以通过npm全局安装：

npm install -g pnpm

安装完成后，验证pnpm版本：

pnpm --version

搭建步骤

1. 初始化项目仓库

首先，创建一个新的文件夹作为您的monorepo根目录，并初始化git仓库（可选但推荐）：

mkdir my-monorepo
cd my-monorepo
git init

2. 配置pnpm工作空间

在项目根目录下创建pnpm-workspace.yaml文件，定义工作空间的结构。此文件告诉pnpm哪些目录包含需要被当作工作空间一部分管理的项目。

# pnpm-workspace.yaml
packages:
  - 'packages/*'
  - 'apps/*'

这里我们定义了两个目录模式：packages/和apps/，它们将分别存放可复用的包和应用程序。

3. 创建项目结构

根据您的需求，在packages/和apps/下创建子项目。例如：

mkdir -p packages/utils apps/web

4. 初始化子项目

进入每个子项目目录，使用pnpm初始化npm项目：

cd packages/utils
pnpm init -y
# 编辑package.json，添加必要的依赖和脚本
cd ../../apps/web
pnpm init -y
# 同样编辑package.json

5. 安装依赖

回到项目根目录，使用pnpm为整个工作空间安装依赖。pnpm会自动处理依赖的共享与隔离：

# 安装公共依赖到根目录（可选）
pnpm add lodash -Dw
# 为特定项目安装依赖
cd packages/utils
pnpm add axios
cd ../../apps/web
pnpm add react react-dom
# 同时，如果web项目需要使用utils包，可以直接引用

6. 配置项目间引用

在monorepo中，项目间可以直接引用彼此的模块，无需发布到npm。在apps/web的package.json中，可以通过相对路径引用packages/utils：

{
  "dependencies": {
    "utils": "workspace:^",
    // 或者指定具体路径
    // "utils": "workspace:packages/utils"
  }
}

7. 运行与构建

pnpm支持在工作空间内运行脚本。例如，在apps/web中定义一个启动脚本：

{
  "scripts": {
    "start": "vite"
  }
}

然后在项目根目录下，使用pnpm的-r（recursive）标志来运行所有或特定项目的脚本：

# 运行所有项目的start脚本（如果它们都有）
pnpm -r start
# 只运行apps/web的start脚本
cd apps/web
pnpm start
# 或者从根目录指定路径
pnpm --filter ./apps/web start

高级配置与优化

使用Hooks自动化

pnpm支持通过hooks自动化工作流，如postinstall钩子可以在安装依赖后自动执行某些操作，如构建或代码生成。

依赖版本锁定

利用pnpm-lock.yaml文件锁定依赖版本，确保团队成员间依赖的一致性。每次安装或更新依赖时，pnpm会自动更新此文件。

工作空间协议

pnpm支持workspace:协议，允许在工作空间内直接引用未发布的本地包，极大地方便了开发过程中的迭代与测试。

结论

通过上述步骤，您已成功搭建了一个基于pnpm与monorepo的多项目工作空间。这种架构不仅优化了依赖管理，减少了存储空间的浪费，还促进了代码的复用与模块化，提高了开发效率与团队协作能力。无论是小型团队还是大型项目，pnpm+monorepo的组合都是一个值得尝试的高效解决方案。随着项目的不断扩展，您还可以进一步探索pnpm的高级功能，如工作空间特定的脚本、环境变量管理等，以持续优化开发流程。