How to control pnpm workspace build order

在使用pnpm作为包管理工具时，如果你有一个工作区（workspace）项目，可能需要对子包（packages）进行构建，并且这些包之间存在依赖关系。为了控制它们的构建顺序，让依赖项先被构建，你可以使用pnpm的几种策略。

1. 使用pnpm -r或--recursive

pnpm支持递归地在工作区中运行命令，它会自动识别包之间的依赖关系并按照正确的顺序运行。

sh
pnpm -r --filter <filter-pattern> run <command>

例如，如果你想要构建所有的包，可以使用：

sh
pnpm -r run build

2. 使用--sort标志

在运行pnpm -r时，可以添加--sort标志，这样pnpm将按照拓扑顺序执行命令，确保依赖先于依赖它们的包被处理。

sh
pnpm -r --sort run build

3. 使用pnpm的pnpm-workspace.yaml文件

通过在pnpm-workspace.yaml文件中声明包的顺序，pnpm会在执行命令时考虑这个顺序。

yaml
packages:
  - 'packages/utils'
  - 'packages/core'
  - 'packages/app'

pnpm会首先处理packages/utils，然后是packages/core，最后是packages/app。

4. 使用pnpm的过滤标志

pnpm支持使用过滤标志来限制命令运行的包的范围。

sh
pnpm -r --filter "<package-name>" run build

你可以指定多个过滤条件来控制执行顺序。

5. 编写自定义脚本

如果你有特别复杂的构建需求，可以编写自定义的脚本来控制构建过程。例如，你可以使用Node.js脚本来分析package.json文件中的依赖，并按照你的特定需求执行构建任务。

javascript
const { execSync } = require('child_process');
const { getWorkspaces } = require('some-workspaces-tool');

const buildPackage = (packageName) => {
  console.log(`Building ${packageName}...`);
  execSync(`pnpm run build`, { stdio: 'inherit', cwd: `packages/${packageName}` });
};

const workspaces = getWorkspaces();

// 自定义逻辑来排序和构建包
workspaces.sort(customSortFunction).forEach((workspace) => {
  buildPackage(workspace.name);
});

示例：

假设你有一个名为@company/core的包，它依赖于@company/utils。你希望在构建@company/core之前构建@company/utils。

你可以在pnpm-workspace.yaml中像这样指定包的顺序：

yaml
packages:
  - 'packages/utils'
  - 'packages/core'

然后运行以下命令确保按照正确的顺序进行构建：

sh
pnpm -r --sort run build

这会首先构建utils包，然后是core包。

使用pnpm的这些工具和策略，你可以有效地管理你的工作区项目的构建顺序，确保构建过程的正确性和效率。