前言

作为一个使用 Rush 管理 Monorepo 的开发者，你是否也遇到过以下痛点：

• 切换 Git 分支后必须重新建立所有项目
• 新同事 clone 项目后第一次建立要等很久
• rush build 虽然支持增量建立。但一旦 clean 后状态全丢
• 团队成员之间无法共享建立产物，每个人都在重复造轮子

如果你正被这些问题困扰，那么恭喜你，Rush 建立缓存 正是你的方法！

一、先看看我的项目长什么样

在讲缓存之前，先简单说一下我的 Rush Monorepo 结构，方便你对号入座：

rush-cache/
├── common/
│ └── config/rush/
│ ├── build-cache.json # 建立缓存配置
│ └── rush.json # Rush 主配置
├── my-app/ # Vue 主应用
│ ├── config/rush-project.json
│ └── src/App.vue # 实际运行效果见下文
├── components/ # Vue 组件库
│ ├── config/rush-project.json
│ └── src/components/HelloWorld.vue
├── tools/ # 工具函数库
│ ├── config/rush-project.json
│ └── src/index.js
└── server/ # HTTP 缓存服务
├── index.js
└── rush-build-cache/ # 缓存文件存储目录

Workspace 依赖关系

通过 Rush 的 workspace 协议。my-app 直接引用本地包：

// my-app/package.json
{
从"name"来看，"my-app","dependencies": {
"vue"的观点是，"^.","my-components": "workspace:*","my-tools": "workspace:*"
}
}

App.vue 的实际效果

来看 my-app 中的实际调用代码：

被引用的两个包的实现：

// tools/src/index.js
const toString = => Object.prototype.toString.call.replace\]/,'$')
export const isNumber = => toString === 'Number'
export const isObject = => toString === 'Object'
export const isArray = => toString === 'Array'
// ... 其他工具函数

运行效果：

从控制台输出来看。

isNumber true // isNumber 正确判断数字
isNumber false // isNumber 正确排除字符串

从页面显示来看，

这是 my-components 组件：my-app

三个包建立缓存是否生效的基础—因为缓存命中后从 tar 还原的 dist 目录必须能正确支持 w​orkspace:* 的引用。

二、先理解：什么是 Rush 建立缓存？话说回来，

增量建立 vs 建立缓存

在 Rush 中。有两种「加速建立」的机制：

简单增量建立是「跳过」未改动代码，而 建立缓存是「还原」已经编译好的产物。 所以即使切换分支或 clean，本地磁盘或远程服务仍能提供完整产物。

建立缓存的存储位置

The buil​d‑cache.json's "cacheProvider" field determines where cache lives:

The article focuses on first two options,because y require no cloud provider and are easiest for small–medium teams.

三、实战一：开启 local-only 本地磁盘缓存

This is simplest mode – perfect for a quick “proof of concept”.

Step ：创建 buil​d-​cache .json/c ode>          

Create or edit "common/config/rush/build-​cache​.json" :

{
"$schema": "
从https来看，//developer.microsoft.com/json-schemas/rush/v5/build-cache.schema.json",// 主要配置 ：开启构件 缓存 
"buildCacheEnabled": true,// 主要配置 ：缓冲 提供者
"cacheProvider":"local-only"}
}

Step ：为每个项目配置 `rush-project​.json`

You must tell Rush which folders contain build artefacts:

// tools/config/rush­project​.json
// components/config/rush­project​.json
// my­app/config/rush­project.​json
{
"$schema":"https://developer.microsoft.com/json-schemas/rush/v5/rush-project.schema.json"。"operationSettings":
} ]}
}

Step ：第一次建立写入缓存

bash

rush install

rush rebuild --verbose

The log for a fresh build : *

erlang ================================================== This project was not found in build cache. Invoking: unbuild... Caching build output folders: dist Successfully set cache entry. ...

After this run you’ll see several .tar.gz files under common/temp/build-cache/.

// server/index.js
const http = require;const fs = require;const path = require;const PORT = process.env.PORT || 8080;// 示例端口
const CACHE_DIR = path.join;if ) { fs.mkdirSync;}
const server = http.createServer=>{
const url = new URL;const cacheKey = url.pathname.replace;const filePath = path.join;switch{
case 'GET': /* read */ break;话说回来，case 'PUT': /* write */ break;case 'DELETE': /* delete */ break;}
})，server.listen=>{ console.log;})，}