Yarn 安装与使用教程
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 提供的各种命令，提高开发效率。