yarn的安装与配置（秒懂yarn用法）

Yarn是由Facebook、Google、Exponent和Tilde联合开发的一个JavaScript包管理工具。它旨在解决npm的一些缺点，如速度慢、依赖解析不一致等问题。Yarn通过并行安装、缓存和严格的依赖解析机制，提供了更快、更稳定的包管理体验。本文将引导读者从Yarn的安装开始，逐步了解其配置和基本用法，帮助读者快速上手并掌握Yarn。

2. 为什么选择Yarn

Yarn相较于传统的npm，具有以下几个显著优势：

2.1 高速

Yarn通过并行化操作和本地缓存机制，使得包的安装速度显著提高。即使是第一次安装，Yarn也能比npm快很多倍。

2.2 可靠性

Yarn使用锁文件（yarn.lock）来确保所有开发者和环境中的依赖关系完全一致，从而避免了“它在我的机器上可以运行”的问题。

2.3 安全性

Yarn会在每次安装包时执行校验，确保下载的包没有被篡改，从而增强了安全性。

3. Yarn的安装

3.1 通过npm安装

如果系统中已经安装了Node.js和npm，可以通过npm安装Yarn：

npm install -g yarn

3.2 通过brew安装（适用于macOS）

在macOS上，可以使用Homebrew安装Yarn：

brew install yarn

3.3 通过安装包安装

对于不同操作系统，Yarn官网提供了适用的安装包，可以根据需要下载并安装：

Yarn安装页面

3.4 验证安装

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

yarn --version

如果成功安装，会显示Yarn的版本号。

4. Yarn的配置

Yarn的配置文件是.yarnrc，位于用户主目录或项目根目录中。通过配置文件，可以自定义Yarn的行为。

4.1 设置全局配置

通过命令行，可以设置Yarn的全局配置，例如设置全局缓存目录：

yarn config set cache-folder /path/to/cache

4.2 配置镜像源

为了提高包的下载速度，可以将Yarn的包镜像源设置为国内的镜像源，例如淘宝镜像：

yarn config set registry https://registry.npm.taobao.org/

4.3 配置`.yarnrc`文件

直接编辑.yarnrc文件，也可以进行相应的配置，例如：

# 设置缓存目录
cache-folder "/path/to/cache"
# 设置包镜像源
registry "https://registry.npm.taobao.org/"

5. Yarn的基本用法

5.1 初始化项目

使用Yarn初始化一个新的项目：

yarn init

该命令会交互式地询问项目名称、版本等信息，并生成一个package.json文件。

5.2 添加依赖

通过add命令可以添加项目依赖：

yarn add <package-name>

例如，添加lodash库：

yarn add lodash

5.3 安装依赖

安装项目中的所有依赖：

yarn install

5.4 升级依赖

通过upgrade命令可以升级依赖：

yarn upgrade <package-name>

5.5 移除依赖

通过remove命令可以移除依赖：

yarn remove <package-name>

5.6 添加开发依赖

通过add命令并加上--dev标志，可以添加开发依赖：

yarn add <package-name> --dev

例如，添加jest作为开发依赖：

yarn add jest --dev

6. Yarn高级用法

6.1 Workspaces

Yarn Workspaces允许在一个仓库中管理多个包，通过共享node_modules来优化依赖的安装。要启用Workspaces，需要在package.json中配置workspaces字段：

{
  "private": true,
  "workspaces": ["packages/*"]
}

在packages目录下，可以创建多个包，每个包都有自己的package.json文件。使用yarn install时，Yarn会自动处理这些包的依赖关系。

6.2 Plug'n'Play (PnP)

Yarn Plug'n'Play是一种新的依赖管理机制，它完全摆脱了node_modules目录，通过生成.pnp.js文件来管理依赖关系。启用PnP，需要在package.json中添加以下字段：

{
  "installConfig": {
    "pnp": true
  }
}

然后运行：

yarn install

6.3 Offline Cache

Yarn支持离线缓存，可以在没有网络连接的情况下安装依赖。要启用离线缓存，需要先运行以下命令：

yarn config set enableOfflineMirror true

然后设置缓存目录：

yarn config set yarn-offline-mirror ./offline-cache

之后，每次安装依赖时，Yarn会将包存储到离线缓存目录中。

7. Yarn命令详解

7.1 yarn init

yarn init命令用于初始化一个新的项目。它会交互式地询问项目的名称、版本、描述、入口文件等信息，并生成一个package.json文件。

yarn init

可以使用-y标志跳过交互式提示，使用默认值生成package.json：

yarn init -y

7.2 yarn add

yarn add命令用于添加依赖。可以指定多个包名，并且支持指定版本号或范围。

yarn add lodash

添加特定版本的包：

yarn add lodash@4.17.20

添加多个包：

yarn add lodash axios

添加开发依赖：

yarn add jest --dev

7.3 yarn install

yarn install命令用于安装项目中的所有依赖。如果yarn.lock文件存在，Yarn会根据该文件安装精确版本的依赖。

yarn install

7.4 yarn upgrade

yarn upgrade命令用于升级依赖。可以指定包名和版本号。

yarn upgrade lodash

升级到特定版本：

yarn upgrade lodash@4.17.20

7.5 yarn remove

yarn remove命令用于移除依赖。

yarn remove lodash

7.6 yarn run

yarn run命令用于运行在package.json中定义的脚本。例如，运行start脚本：

yarn run start

可以省略run：

yarn start

7.7 yarn cache

yarn cache命令用于管理Yarn的缓存。

清理缓存：

yarn cache clean

查看缓存路径：

yarn cache dir

8. Yarn与npm的对比

8.1 性能对比

Yarn的并行安装机制和缓存机制，使得其在安装依赖时比npm更快。在大项目中，这种性能优势更加明显。

8.2 锁文件

Yarn使用yarn.lock文件来确保依赖的一致性，而npm使用package-lock.json文件。两者的目的相同，但Yarn的锁文件解析速度更快，且冲突处理机制更完善。

8.3 安全性

Yarn在安装包时会进行校验，确保下载的包没有被篡改，从而提供更高的安全性。而npm直到npm@6版本才引入了类似的安全功能。

9. 常见问题与解决

9.1 Yarn安装速度慢

如果在国内使用Yarn，可能会遇到包下载速度慢的问题。可以通过配置国内镜像源来解决：

yarn config set registry https://registry.npm.taobao.org/

9.2 依赖冲突

如果遇到依赖冲突问题，可以尝试删除node_modules目录和yarn.lock文件，然后重新安装依赖：

rm -rf node_modules yarn.lock
yarn install

9.3 Yarn与npm混用问题

尽量避免在同一个项目中混用Yarn和npm，因为它们的锁文件格式不同，可能会导致依赖关系不一致。如果必须混用，可以删除package-lock.json文件，确保Yarn的锁文件生效。

10. 总结

Yarn作为一个快速、可靠和安全的JavaScript包管理工具，在现代Web开发中发挥着重要作用。通过本文的介绍，读者可以了解到Yarn的安装与配置，并掌握其基本用法和高级功能。在实际项目中，合理使用Yarn，可以显著提升开发效率和代码质量。无论是初始化项目、添加依赖、还是管理多包项目，Yarn都提供了丰富的工具和灵活的配置选项，帮助开发者更高效地管理项目依赖。希望本文能够帮助读者更好地理解和使用Yarn，为其开发工作带来便利。