Turborepo 项目安装与配置完全指南

Turborepo 项目安装与配置完全指南

turbo Incremental bundler and build system optimized for JavaScript and TypeScript, written in Rust – including Turbopack and Turborepo. 项目地址: https://gitcode.com/gh_mirrors/tu/turbo

什么是 Turborepo

Turborepo 是一个高性能的 JavaScript/TypeScript 单仓库(monorepo)构建系统，它能显著提升项目的构建速度和开发体验。通过智能的任务调度和缓存机制，Turborepo 可以避免重复工作，使开发团队能够更高效地协作。

快速开始

要创建一个新的 Turborepo 项目，可以使用以下命令（根据你偏好的包管理器选择）：

# 使用 pnpm
pnpm dlx create-turbo@latest

# 使用 yarn
yarn dlx create-turbo@latest

# 使用 npm
npx create-turbo@latest

# 使用 bun (Beta)
bunx create-turbo@latest

这个命令会创建一个包含以下内容的初始项目结构：

• 两个可部署的应用程序
• 三个可在整个单仓库中共享的库

Turborepo 的两种安装方式

1. 全局安装（推荐）

全局安装 Turborepo 可以让你在任何地方快速使用 turbo 命令，提高开发效率。

# pnpm
pnpm install turbo --global

# yarn
yarn global add turbo

# npm
npm install turbo --global

# bun
bun install turbo --global

全局安装后，你可以直接在终端使用 turbo 命令，例如：

• turbo build：按照依赖关系图执行构建任务
• turbo build --filter=docs --dry：预览 docs 包的构建任务（不实际执行）
• turbo generate：运行代码生成器
• cd apps/docs && turbo build：在 docs 包及其依赖项中执行构建

重要提示：

• turbo 是 turbo run 的别名，两者功能相同
• 避免使用不同包管理器重复全局安装 turbo，这可能导致意外行为

2. 项目本地安装

为了确保团队所有成员使用相同版本的 Turborepo，建议在项目中将其添加为开发依赖：

# pnpm
pnpm add turbo --save-dev --ignore-workspace-root-check

# yarn
yarn add turbo --dev --ignore-workspace-root-check

# npm
npm install turbo --save-dev

# bun
bun install turbo --dev

本地安装的优势在于：

• 锁定特定版本，确保团队一致性
• 全局安装的 turbo 会自动检测并使用项目本地的版本
• 便于 CI/CD 环境的配置

最佳实践建议

1. 双重安装策略：同时使用全局和本地安装，既保证开发便利性，又确保版本一致性

2. CI/CD 集成：在持续集成环境中，可以使用全局安装的 turbo 来提高构建效率

3. 版本管理：定期更新项目中的 turbo 版本以获取最新功能和性能优化

4. 任务编排：充分利用 turbo 的任务编排能力，合理设计项目结构和任务依赖关系

通过以上安装和配置，你可以充分发挥 Turborepo 在单仓库项目管理中的优势，显著提升开发效率和构建速度。

turbo Incremental bundler and build system optimized for JavaScript and TypeScript, written in Rust – including Turbopack and Turborepo. 项目地址: https://gitcode.com/gh_mirrors/tu/turbo