package.json 的 “workspaces“有什么作用

package.json 中的 "workspaces" 字段是现代前端工程化（尤其是 Monorepo 架构）的核心配置。它的主要作用是告诉包管理器（如 NPM、Yarn、pnpm），你的项目是一个包含多个子包的"单体仓库"，并指定这些子包的位置。

简单来说，它让包管理器能够在一个命令下同时管理多个包的依赖，并自动处理包与包之间的关联。

以下是它的核心作用详解：

🔗 自动链接本地包（符号链接）

这是 Workspaces 最强大的功能。

假设你的项目结构如下：

1my-monorepo/
2├── package.json      # 配置了 workspaces
3├── packages/
4│   ├── ui/           # 包 A
5│   └── utils/        # 包 B

如果 ui 包依赖 utils 包，在没有 Workspaces 时，你需要手动 npm link 或者发布 utils 到远程仓库再安装。
有了 Workspaces：

包管理器会自动检测到 utils 是本地包，并直接在 ui/node_modules 中创建一个指向 ../utils 的符号链接 。你修改 utils 的代码，ui 中会立即生效，无需重新安装或发布。

🚀 提升安装效率（依赖提升）

Workspaces 会执行依赖提升 。

它会分析所有子包（packages/*）的 package.json，将大家共用的依赖（比如 lodash、react）提取并安装到根目录 的 node_modules 中。

• 节省磁盘空间： 避免每个子包都下载一份相同的依赖。
• 加快安装速度： 减少了重复下载和文件写入。

🛠️ 统一执行命令

配合包管理器（特别是 Yarn 和 pnpm），你可以用一条命令在所有子包中运行脚本。

例如，你想在所有包里运行测试：

• Yarn: yarn workspaces run test
• pnpm: pnpm -r run test
• NPM: npm run test --workspaces

---

⚙️ 如何配置

在根目录的 package.json 中添加 workspaces 字段：

1{
2  "name": "my-monorepo",
3  "private": true, 
4  "workspaces": [
5    "packages/*", 
6    "apps/*"
7  ]
8}

• "packages/*" : 表示 packages 文件夹下的所有子文件夹都是子包。
• "private": true : 强烈建议 在 Monorepo 的根 package.json 中加上这个字段，防止你不小心把根项目发布到 NPM 仓库。

📌 总结：它解决了什么问题？

表格

场景	没有 Workspaces	有 Workspaces
包 A 引用 包 B	需手动 npm link 或发布后安装，极其繁琐	自动软链接，实时生效
安装依赖	需进入每个子包分别运行 npm install	根目录运行一次，自动搞定所有
磁盘占用	每个包都有独立的 node_modules，重复多	依赖提升到根目录，共用一份

一句话总结： "workspaces" 让管理包含几十甚至上百个子包的大型项目，变得像管理单个项目一样简单。