秒懂 Yarn：安装与配置全攻略

一、Yarn 是什么

Yarn 是什么

Yarn 是一款出色的软件包管理工具，由 Facebook 等开发。它具有诸多显著特点和优势，旨在为开发者提供更高效、可靠和便捷的依赖管理体验。

在特点方面，Yarn 以其快速的性能脱颖而出。它通过并行下载和缓存机制，大大提高了依赖包的安装速度。相比之下，传统的包管理工具可能按顺序逐个下载，效率较低。此外，Yarn 还具备出色的安全性。在执行代码前，它会通过算法校验每个安装包的完整性，降低了恶意代码入侵的风险。同时，Yarn 采用简洁明了的锁文件格式和明确的安装算法，确保在不同系统上工作的一致性和可靠性。

优势方面，Yarn 提供了确定性保障，每次安装的依赖包版本相同，有效避免了依赖冲突和环境差异导致的问题。其易用性也备受赞誉，简洁的命令行接口让开发者易于上手和操作。而且，Yarn 拥有活跃的社区支持和持续的更新，不断完善和优化其功能。

总之，Yarn 作为软件包管理工具，凭借其快速、安全、可靠和易用等特点，以及在版本控制、社区支持等方面的优势，成为了众多开发者的首选，为项目的开发和维护带来了极大的便利。

二、Yarn 安装前的准备

在安装 Yarn 之前，必须先安装 Node.js 。Node.js 为 Yarn 的运行提供了必要的环境支持。

要查看 Node.js 的版本，有多种方法可供选择。

1. 使用命令行查看版本号：

• • 在 Windows 操作系统中，打开 Node.js 命令提示符，输入node -v命令，系统将显示当前安装的 Node.js 版本号。

• • 在 Linux 和 macOS 操作系统中，打开终端输入node -v，同样可以获取版本信息。

1. 使用 Node.js REPL 查看版本号：Node.js REPL 是一个实用的工具，在其中输入process.version命令，即可返回当前安装的 Node.js 版本号。

1. 使用 Node.js 代码查看版本号：编写一个简单的 Node.js 程序，在代码中添加console.log(process.version)，然后在终端中运行该程序，也能看到当前的 Node.js 版本号。

1. 使用 NPM 查看 Node.js 版本号：NPM 是 Node.js 的包管理器，通过在终端输入npm -v命令，返回的 NPM 版本通常与 Node.js 版本一起更新，从而可间接了解 Node.js 的版本。

通过上述方法，您能够方便地查看 Node.js 的版本，确保在安装 Yarn 前，Node.js 已正确安装并符合要求。

三、Yarn 的安装方法

1. 通过 npm 安装 Yarn

首先，确保您的系统已经安装了 Node.js 并且其自带的 npm 包管理器可以正常使用。

在 Windows 操作系统中，您可以以管理员身份打开命令提示符（CMD），输入以下命令进行全局安装：

npm install --global yarn

在 macOS 和 Linux 操作系统中，打开终端直接输入上述命令即可。安装完成后，您可以通过输入yarn -v命令来验证 Yarn 是否安装成功以及查看其版本信息。

2. 其他安装 Yarn 的方式及注意事项

通过安装程序安装（Windows）：

访问 Yarn 官方网站，下载适用于 Windows 的.msi 安装包。运行该安装包，按照向导进行操作，注意在安装过程中勾选“Add to PATH”选项，以便在全局范围内使用 Yarn 命令。

通过 Homebrew 安装（macOS）：

先确保已安装 Homebrew 包管理器，如果没有，请运行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/main/install.sh)"命令进行安装。然后使用brew install yarn命令安装 Yarn。

通过包管理器安装（Linux）：

对于基于 Debian/Ubuntu 的系统，使用sudo apt update和sudo apt install yarn命令。对于基于 CentOS/Fedora/RHEL 的系统，使用sudo yum install yarn命令。

注意事项：

• 无论采用哪种安装方式，都需要保持网络连接良好，因为 Yarn 及其依赖包需要在线下载。

• 建议安装最新稳定版本的 Yarn，可通过官方文档获取最新安装指令。

• 如果使用 npm 全局安装，要确认 npm 的全局模块目录已被添加到 PATH 环境变量中，否则可能需要手动调整环境变量。

• 安装完成后，建议通过运行yarn --version来验证安装是否成功。

四、Yarn 的配置要点

1. 配置 Yarn 的全局目录和缓存目录

要配置 Yarn 的全局目录和缓存目录，以下是具体步骤：

首先，打开终端并进入您的项目目录。

配置全局目录：

运行命令 yarn config set global-folder "您指定的全局目录路径"，例如：

yarn config set global-folder "D:\\tools\\yarn\\global" 。

配置缓存目录：

执行命令 yarn config set cache-folder "您指定的缓存目录路径"，比如：

yarn config set cache-folder "D:\\tools\\yarn\\cache" 。

配置完成后，您可以通过以下命令验证配置是否生效：

yarn config get global-folder 查看全局目录配置。

yarn config get cache-folder 查看缓存目录配置。

2. 修改 Yarn 的镜像源以加速下载

修改 Yarn 的镜像源可以显著提高下载速度。以下是几种常见的方法：

方法一：临时修改

运行命令

yarn save 软件名 --registry https://registry.npm.taobao.org/ 。

方法二：全局修改

使用命令

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

方法三：使用第三方工具 yrm

首先，安装 yrm ：

npm install -g yrm

然后，列出可用的镜像源： 

yrm ls

切换到淘宝镜像源：

yrm use taobao 

您还可以通过 yrm test 镜像源 来测试访问速度。

通过以上方法，您可以根据实际需求选择合适的方式来修改 Yarn 的镜像源，从而加快下载速度，提升开发效率。

五、Yarn 常用命令及用法

1. 列举并解释 Yarn 初始化项目、安装依赖等常用命令

Yarn 常用命令丰富多样，以下为您详细介绍几个关键命令：

初始化项目

yarn init 命令用于初始化一个新的项目。执行该命令后，系统会引导您输入项目的相关信息，如名称、版本、描述等，最终生成 package.json 文件来管理项目的配置。

安装依赖

• yarn install ：安装 package.json 中声明的所有依赖包，并将其及依赖项保存进 yarn.lock 文件。

• yarn add [package] ：在当前项目中添加一个依赖包，会自动更新到 package.json 和 yarn.lock 文件中。

• yarn add [package]@[version] ：以指定的版本安装依赖包。

• yarn add [package] -D 或 yarn add [package] --dev ：将依赖包添加为开发依赖。

2. 举例说明命令在实际项目中的应用

假设我们正在开发一个 Web 应用项目，首先使用 yarn init 初始化项目，生成 package.json 。然后，如果项目需要引入 lodash 库作为依赖，我们可以使用 yarn add lodash 命令来安装。若要指定版本，比如安装 lodash 的 4.17.21 版本，可使用 yarn add lodash@4.17.21 。如果这个库仅在开发过程中使用，比如用于代码测试或构建工具，就使用 yarn add lodash -D 。

在项目开发过程中，如果发现某个依赖包有更新，需要将其升级到最新版本，可以使用 yarn upgrade lodash 命令。如果项目开发完成，不再需要某个依赖包，例如 moment 库，可通过 yarn remove moment 命令将其移除。

总之，熟练掌握和运用这些 Yarn 常用命令，能够高效地管理项目依赖，提升开发效率和项目质量。

六、Yarn 安装与配置的常见问题及解决

1. 安装过程中的常见问题

• 安装缓慢或失败：可能是网络问题，尝试切换网络环境或修改镜像源。

• 权限不足：在 Windows 系统中，可能需要以管理员身份运行安装命令。

• 依赖冲突：可能由于其他软件包与 Yarn 的依赖存在冲突，需要排查并解决冲突的依赖。

2. 配置过程中的常见问题

• 全局目录和缓存目录配置未生效：确认命令输入正确，且环境变量设置正确。

• 镜像源修改后仍速度慢：检查镜像源地址是否正确，或者尝试其他可靠的镜像源。

3. 问题解决办法

• 安装缓慢或失败：

• • 检查网络连接，确保网络稳定。

• • 对于 Windows 系统，右键命令提示符选择“以管理员身份运行”。

• • 若依赖冲突，通过查看错误日志或相关提示，卸载冲突的依赖，再重新安装 Yarn。

• 全局目录和缓存目录配置未生效：

• • 重新执行配置命令，仔细检查路径是否输入正确。

• • 检查系统环境变量，确保配置的路径已正确添加。

• 镜像源修改后仍速度慢：

• • 确认镜像源地址是否最新、有效。

• • 尝试其他流行的镜像源，如国内其他稳定的镜像站点。

在安装和配置 Yarn 时，遇到问题不要慌张，仔细分析错误提示和相关日志，多数情况下都能顺利解决。