Nx 是一个面向 TypeScript 及多语言代码库的单仓库解决方案。它基于 Rust 构建，具备卓越性能，并可通过 TypeScript 进行扩展。Nx 会缓存未发生变化的内容，仅运行受影响的部分，并内置 CI 解决方案。您可以从简单起步，随着业务增长逐步扩展。

快速入门

请访问 Nx 快速入门文档，开始您的旅程。

为什么选择 Nx？

• 增量式设计 - 在任何 npm/pnpm/yarn 工作区中运行 npx nx init。Nx 会自动识别您现有的 package.json 脚本，缓存其输出，并仅执行受影响的部分，无需对现有配置进行任何修改。
• 原生支持 AI 的工具链 - Nx CLI 针对自主 AI 代理进行了优化，使其能够获取所需上下文并像人类一样高效工作。了解更多 »
• 多语言插件系统 - 可选插件可自动发现任务、配置缓存输入输出，并根据您实际使用的工具生成代码骨架。支持 Vite、Webpack、Jest、Vitest、ESLint、Gradle、Maven、.NET、Go 等技术栈，以及更多其他技术。查看完整列表 »
• 集成 CI 解决法 - 将 Nx 与您的 CI 提供商（GitHub Actions、GitLab、Azure 等）连接，即可实现远程缓存、跨机器的任务分配、仅运行受影响部分以及自动拆分端到端测试等功能。了解更多 »
• 自愈型 CI - 在您的 CI 流水线中部署 AI 代理，它可以检测失败、分析根本原因、提出修复方案并自动验证。本地代理通过 MCP 协议与 CI 系统连接，从而实现故障的自主检测与修复。了解更多 »

哪些企业使用 Nx？

从初创公司到财富 500 强企业，众多组织都在使用 Nx。查看我们的成功案例 »

想要参与贡献吗？

如果您想提交 bug 或 PR，请先阅读我们的贡献指南。

核心团队

维克托·萨夫金	杰森·让	本杰明·卡巴内斯	杰克·许
vsavkin	FrozenPandaz	bcabanes	jaysoo

詹姆斯·亨利	乔恩·卡米苏利	马克斯·克莱斯	尤里·斯特鲁姆普洛纳
JamesHenry	cammisuli	MaxKless	juristr

菲利普·富尔彻	凯莱布·乌克勒	科伦·费里	史蒂文·南斯
philipjfulcher	barbados-clemens	Coly010	llwt

米罗斯拉夫·约纳斯	列奥斯维尔·佩雷斯·埃斯皮诺萨	扎卡里·德罗斯	克雷戈里·科波拉
meeroslav	leosvelperez	ZackDeRose	AgentEnder

仇·陈	妮可·奥利弗	拉雷斯·马泰伊	阿尔坦·斯塔尔克
nartc	nixallover	rarmatei	StalkAltan

乔什·范艾伦	奥斯汀·法斯尔	路易·温
joshvanallen	fahslaj	lourw

Nx 快速上手指南

Nx 是一个专为 TypeScript 及多语言代码库设计的智能单体仓库（Monorepo）解决方案。它基于 Rust 构建以确保高性能，支持增量构建、任务缓存和受影响项目检测，帮助开发者从简单起步并随业务扩展。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• Node.js：建议安装 LTS 版本（v18.x 或更高）
• 包管理器：npm、pnpm 或 yarn（任选其一）
• Git：已安装并配置好

💡 国内加速建议： 如果下载依赖较慢，建议配置国内镜像源：

• npm: npm config set registry https://registry.npmmirror.com
• pnpm: pnpm config set registry https://registry.npmmirror.com
• yarn: yarn config set registry https://registry.npmmirror.com

安装步骤

您可以将 Nx 添加到现有的项目中，或者创建一个新的 Nx 工作区。

方式一：在现有项目中初始化（推荐）

如果您已经有一个使用 npm/pnpm/yarn workspaces 管理的项目，可以直接运行以下命令初始化 Nx：

npx nx init

Nx 会自动识别现有的 package.json 脚本，配置缓存输入/输出，并无需更改现有设置即可启用增量运行。

方式二：创建全新的 Nx 工作区

如果您想从头开始创建一个新项目：

npx create-nx-workspace@latest my-app

按提示选择技术栈（如 React, Angular, Node 等）和包管理器。

基本使用

初始化完成后，您可以使用 Nx CLI 来运行任务。Nx 的核心优势在于只运行受影响的代码。

1. 运行任务

假设您有一个名为 my-app 的项目，并且需要运行其构建脚本：

npx nx build my-app

或者运行测试：

npx nx test my-app

2. 查看项目依赖图

Nx 可以可视化项目之间的依赖关系，帮助您理解代码结构：

npx nx graph

该命令会在浏览器中打开一个交互式图表，展示所有项目及其依赖连线。

3. 仅运行受影响的代码

当您在 Git 分支上修改了部分代码时，Nx 可以智能地只运行受影响的项目及其依赖项，大幅节省 CI/CD 时间：

npx nx affected --target=build

此命令会对比当前分支与主分支（默认为 main 或 master）的差异，仅构建那些因代码变更而需要重新构建的项目。

4. 并行执行任务

利用多核 CPU 加速构建，默认情况下 Nx 会尽可能并行运行任务：

npx nx run-many --target=build --all

通过以上步骤，您即可体验 Nx 带来的高效构建与智能缓存能力。更多高级功能（如分布式缓存、AI 自愈 CI 等）可查阅官方文档。