5分钟学会使用Rush管理你的monorepo项目

🚀 Rush 是一个强大的 monorepo 管理工具，专门为需要同时构建和发布多个 NPM 包的 JavaScript 开发者设计。在当今前端项目日益复杂的背景下，Rush 能够帮助你轻松管理大型代码仓库，提高团队协作效率。无论你是新手还是资深开发者，都能在短短5分钟内掌握Rush的核心用法！

💡 什么是Rush？

Rush 是微软开发的专业级 monorepo 管理工具，特别适合处理包含大量相互依赖项目的复杂场景。它提供了单次 NPM 安装、自动本地链接、快速并行构建等核心功能，让团队协作变得更加高效。

🔧 Rush的核心优势

⚡ 单次NPM安装

Rush 将所有项目的依赖安装到一个公共文件夹中，避免了传统方式下可能出现的 require() 兄弟项目依赖的问题。它使用符号链接为每个项目重建准确的 "node_modules" 文件夹。

🔗 自动本地链接

在Rush仓库中，所有项目都会自动相互链接。当你做出更改时，无需发布任何内容就能看到下游影响，完全摆脱了 npm link 的烦恼。

🚀 快速并行构建

Rush 检测你的依赖图，并按正确的顺序构建项目。如果两个包不直接相互依赖，Rush 会将它们的构建并行化为独立的 Node.js 进程。

📋 快速开始指南

第一步：安装Rush

npm install -g @microsoft/rush

第二步：克隆仓库

git clone https://gitcode.com/gh_mirrors/ru/rushstack
cd rushstack

第三步：安装依赖

rush install

第四步：构建项目

rush build

🛠️ 常用Rush命令

命令	功能	使用场景
rush install	安装所有依赖	首次设置或依赖变更后
rush build	增量构建	日常开发
rush rebuild	完全重新构建	清理构建缓存
rush change	创建变更记录	发布前准备

📁 项目结构解析

Rush 使用标准的 monorepo 结构：

rushstack/
├── apps/           # 应用程序
├── libraries/      # 共享库
├── heft-plugins/  # Heft插件
├── eslint/         # ESLint配置
└── rush.json       # 主配置文件

🔍 Rush配置文件详解

rush.json 是Rush项目的核心配置文件，包含以下关键设置：

• rushVersion: 指定使用的Rush版本
• pnpmVersion: 包管理器版本配置
• projects: 项目清单，定义所有被管理的包

🎯 实用技巧

1. 子集构建

如果你只需要处理仓库中的几个项目，可以使用：

rush rebuild --to <project>

2. 增量构建

Rush 支持强大的跨项目增量构建，大大提升开发效率。

📊 Rush性能对比

🌟 为什么选择Rush？

✅ 企业级稳定性 - 来自微软SharePoint团队的实际经验
✅ 多包管理器支持 - 支持 PNPM、NPM 和 Yarn
✅ 智能依赖管理 - 自动处理循环依赖
✅ 灵活的工作流 - 支持子集构建和增量构建
✅ 强大的生态系统 - 与 Rush Stack 其他工具完美集成

💎 总结

通过这5分钟的快速学习，你已经掌握了使用Rush管理monorepo项目的基本技能。Rush 的强大功能将帮助你的团队更高效地协作开发，特别是在处理大型、复杂的项目时，Rush 的优势更加明显。

🎉 现在就开始使用Rush，体验专业的monorepo管理！