Yarn 安装与使用教程

Yarn 是一个由 Facebook 开发的 JavaScript 包管理工具，它比传统的 npm 更加高效、可靠，并且在性能上有所提升。Yarn 主要解决了 npm 安装速度慢、并发性差、缓存机制不完善等问题，它提供了更快的安装速度、更稳定的依赖管理和更好的离线使用体验。

本文将详细介绍如何安装和使用 Yarn，以及它的一些常用功能。

---

一、安装 Yarn

1.1 使用 npm 安装 Yarn

如果你已经安装了 npm（Node.js 的包管理工具），可以直接通过以下命令安装 Yarn：

npm install -g yarn

安装完成后，可以通过以下命令验证 Yarn 是否安装成功：

yarn --version

如果命令输出了版本号，则说明安装成功。

1.2 使用 Homebrew 安装 Yarn（macOS）

对于 macOS 用户，推荐使用 Homebrew 安装 Yarn。首先确保你已经安装了 Homebrew，然后运行以下命令：

brew install yarn

安装完成后，使用以下命令验证安装：

yarn --version

1.3 使用 Windows 安装程序（Windows）

Windows 用户可以通过下载安装程序来安装 Yarn。访问 Yarn 官方安装页面 下载最新版本的安装包，并按照提示安装。

安装完成后，打开命令提示符（CMD）或 PowerShell，输入以下命令检查版本：

yarn --version

---

二、初始化项目

2.1 创建项目

在项目文件夹中，运行以下命令来初始化一个新的项目：

yarn init

此命令会引导你输入项目的相关信息，如项目名称、版本、描述等。如果你希望跳过所有提示并使用默认值，可以运行：

yarn init -y

这将自动生成一个 package.json 文件，记录项目的元数据和依赖项。

2.2 安装依赖

通过 Yarn 安装项目依赖非常简单。假设你要安装 react 和 redux，可以运行以下命令：

yarn add react redux

这会将 react 和 redux 安装到 node_modules 目录中，并将它们的版本信息自动记录在 package.json 文件的 dependencies 字段中。

如果你需要安装开发依赖（如 Webpack 或 Babel），可以加上 --dev 参数：

yarn add webpack --dev

这会将依赖项安装到 devDependencies 中。

2.3 安装指定版本的包

如果你希望安装指定版本的依赖，可以通过以下命令指定版本号：

yarn add react@16.8.0

2.4 使用离线缓存安装依赖

Yarn 具有缓存机制，在首次安装时会将依赖项缓存到本地，以便下次使用。如果你在没有网络的情况下需要安装依赖，可以使用缓存安装：

yarn install --offline

---

三、常用命令

3.1 安装依赖

当你克隆一个项目时，或当 package.json 中的依赖发生变化时，可以运行以下命令安装所有依赖：

yarn install

这个命令会根据 package.json 和 yarn.lock 文件安装所有的依赖包。

3.2 升级依赖

要升级某个依赖的版本，可以运行：

yarn upgrade [package-name]@[version]

例如，升级 react 到 17.0.0 版本：

yarn upgrade react@17.0.0

3.3 移除依赖

如果你想卸载某个不再需要的依赖，可以运行：

yarn remove [package-name]

例如，卸载 redux：

yarn remove redux

这会同时移除 node_modules 中的包，并从 package.json 中的依赖项中删除。

3.4 显示已安装的依赖

要查看当前项目中所有安装的依赖，可以使用：

yarn list

这会列出项目中所有的依赖包以及它们的版本。

3.5 生成 lock 文件

yarn.lock 文件记录了所有依赖包及其确切版本，确保项目中所有人安装的依赖版本完全一致。它在运行 yarn install 时会自动生成，如果需要，可以手动删除并重新生成：

rm yarn.lock
yarn install

3.6 运行脚本

在 package.json 中，通常会定义一些项目相关的脚本，比如构建、测试、启动等。你可以使用以下命令运行这些脚本：

yarn run [script-name]

例如，假设 package.json 中定义了一个 start 脚本，可以通过以下命令启动应用：

yarn run start

你也可以简化为：

yarn start

---

四、Yarn 与 npm 比较

4.1 性能差异

Yarn 在性能上比 npm 更加出色。由于 Yarn 使用了并行安装和缓存机制，因此安装速度通常会比 npm 更快。

4.2 安全性

Yarn 提供了 yarn.lock 文件来锁定依赖版本，确保团队成员之间使用的是完全一致的版本，避免了因版本差异导致的潜在问题。而 npm 在 5.x 版本之后也引入了 package-lock.json 文件，功能类似。

4.3 离线模式

Yarn 提供了完整的离线安装支持。当某个包被下载并缓存后，即使没有网络连接，也能继续安装依赖。而 npm 在这方面的支持则较为有限。

---

五、总结

Yarn 是一个快速、可靠的 JavaScript 包管理工具，它相较于 npm 提供了更好的性能、更强的缓存机制和更好的离线支持。如果你正在构建一个现代 JavaScript 应用，Yarn 是一个值得考虑的工具。

通过本文，你已经学会了如何安装和使用 Yarn，包括创建项目、安装依赖、运行脚本等常见操作。你可以在实际项目中根据需要灵活使用 Yarn 提供的各种命令，提高开发效率。