开发人员入门

先决条件

为了使用 Rush，您将需要 NodeJS 引擎。我们推荐最新的 LTS 版本，因为非稳定版本的 NodeJS 经常存在错误。您可以考虑通过 nvm-windows 或 nvm (Mac/Linux) 安装，这样您可以轻松地在您所工作的不同项目所需的不同的 NodeJS 版本之间切换。

您还需要安装 Rush 工具本身。这很简单。从您的 shell 或命令提示符中，输入以下命令

npm install -g @microsoft/rush

注意：如果此命令失败，因为您的用户帐户没有权限访问 NPM 的全局文件夹，您可能需要 修复您的 NPM 配置。

要查看 Rush 的命令行帮助，您可以输入

rush -h

命令行帮助也在网上发布在 命令参考 中。

一些注意事项

在我们开始之前，请记住以下几点

1. 避免在 Rush 仓库中使用某些命令

Rush 通过将所有依赖项包安装到一个中央文件夹中进行优化，然后使用 符号链接 为您的每个项目创建 “node_modules” 文件夹。

避免使用安装/链接依赖项的包管理器命令。例如，npm run 可以正常工作，但以下命令会被 Rush 的符号链接搞混：npm install、npm update、npm link、npm dedupe 等。（对于其他包管理器也是如此：避免使用诸如 pnpm install 或 yarn install 之类的命令。）如果您想使用这些命令，请先运行 rush unlink 删除 Rush 创建的符号链接。

如果您使用 git clean -dfx 清理您的文件夹，请注意它对符号链接的处理很差。为了避免麻烦，在使用 git clean -dfx 之前，请始终运行 rush unlink。

之后，您可以运行 rush update 来重新创建符号链接。（有一个独立的 rush link 命令，但很少需要。）

2. 如果您怀疑安装已损坏...

Rush 的包管理命令是 “增量” 的，这意味着它们通过跳过看似不必要的步骤来节省时间。由于 Rush 在自动构建环境中运行，因此我们有许多安全措施来确保这些检查是准确的。但是，在本地机器上调试或修改包时，有时您的 NPM “node_modules” 文件夹会进入不良状态，导致奇怪的错误。

如果您怀疑安装已损坏，请尝试运行 rush update --purge。这将强制重新安装所有包，通常会让您恢复到良好状态。