当前位置：首页 > news >正文

yarn的安装和配置以及更新总结，npm的对照使用差异

news 2025/10/27 18:44:26

1. Yarn简介

Yarn 是一个由 Facebook 开发的现代 JavaScript 包管理器，旨在提供更快、更安全、更可靠的包管理体验。

1.1 什么是Yarn

Yarn 是一个快速、可靠和安全的 JavaScript 包管理器，它通过并行化操作和智能缓存机制，显著提升了依赖安装的速度。Yarn 还提供了离线支持，即使在没有网络的情况下，也能安装依赖包。此外，Yarn 使用 yarn.lock 文件锁定依赖版本，确保在不同环境中安装的依赖包版本一致，避免了“在我这能运行”的问题。

1.2 Yarn的主要特点

Yarn 的主要特点包括：

速度快：Yarn 通过并行化操作，使得依赖安装速度远超传统的 npm 包管理器。
离线模式：Yarn 支持离线模式，可以在没有网络的情况下安装依赖，因为它会缓存之前下载过的包。
确定性：Yarn 使用 yarn.lock 文件确保每次安装的依赖版本一致，无论在哪个系统或何时安装。
安全性：Yarn 在安装包之前会检查其完整性，确保包没有被篡改。
更好的语义化：Yarn 的命令和输出信息更友好、更易读，方便开发人员理解和使用。
跨平台兼容性：Yarn 可以在多种操作系统上运行，包括 Windows、macOS 和 Linux，确保了广泛的适用性和一致性。

2. Yarn的安装

2.1 在不同操作系统上的安装方法

Yarn支持跨平台安装，包括Windows、macOS、Linux等操作系统。以下是针对不同操作系统的安装指南：

Windows: 在Windows系统上，可以通过以下两种方式安装Yarn：
- 使用npm：运行命令 npm install --global yarn 来安装Yarn。
- 使用Chocolatey：如果已经安装了Chocolatey，可以通过 choco install yarn 命令进行安装。
macOS: 在macOS上，推荐使用Homebrew进行安装，使用命令 brew install yarn。

Linux (Ubuntu/Debian): 在基于Debian的系统上，可以添加Yarn的官方仓库并使用apt进行安装：

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install yarn

Linux (CentOS/RHEL): 在基于RPM的系统上，可以添加Yarn的官方仓库并使用yum进行安装：

curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo yum install yarn

2.2 通过npm安装Yarn

npm是Node.js的包管理器，Yarn可以通过npm进行安装。这是Yarn官方推荐的安装方法，因为它确保了Yarn与Node.js的兼容性。以下是通过npm安装Yarn的步骤：

确保系统中已安装Node.js，可以通过运行 node -v 和 npm -v 来检查Node.js和npm的版本。
使用npm全局安装Yarn，运行命令 npm install --global yarn。
安装完成后，可以通过运行 yarn --version 来验证Yarn是否安装成功。

通过npm安装Yarn是一种简单且跨平台的方法，适用于大多数操作系统。安装完成后，就可以开始使用Yarn来管理JavaScript项目的依赖了。

3. Yarn的配置

3.1 配置环境变量

配置环境变量是确保Yarn能够全局访问的关键步骤。在Unix-like系统（包括Linux和macOS）中，通常需要编辑shell配置文件，如.bashrc、.zshrc或.profile。例如，在.bashrc文件中添加以下行：

export PATH="$PATH:$(yarn global bin)"

在Windows系统中，可以通过系统属性中的环境变量设置来添加Yarn的安装路径到PATH变量。确保Yarn的可执行文件路径被添加到PATH中，使得可以在命令行中直接调用yarn命令。

3.2 设置国内镜像源

由于网络问题，直接使用npm官方源在中国大陆可能会遇到访问速度慢或无法访问的问题。Yarn支持设置镜像源以加速包的下载。以下是设置国内镜像源的步骤：

使用淘宝的npm镜像作为Yarn的registry，可以通过以下命令设置：
```
yarn config set registry https://registry.npm.taobao.org
```
这将使得Yarn在安装包时使用淘宝的镜像源，显著提高下载速度。

如果需要使用其他镜像源，如npmmirror或cnpm，可以通过替换URL来设置：

yarn config set registry https://registry.npmmirror.com
# 或者
yarn config set registry https://r.cnpmjs.org

查看当前Yarn配置，确保镜像源设置正确：
```
yarn config list
```

通过以上步骤，可以确保Yarn在使用过程中能够享受到更快的下载速度，特别是在中国大陆地区。同时，合理配置环境变量能够提高开发效率，确保开发环境的稳定性。

4. Yarn常用命令

4.1 安装依赖

Yarn提供了多种方式来安装项目依赖，以确保开发环境的一致性和稳定性。

yarn install：这是最常用的命令，用于根据package.json和yarn.lock文件安装所有依赖。如果yarn.lock文件存在，Yarn将确保安装与锁文件中记录的确切版本相同的依赖，从而保证不同环境下的一致性。
yarn install --flat：此命令安装所有依赖，但每个包只允许一个版本。首次运行时，如果存在多个版本范围的依赖，Yarn会提示选择一个版本，并将选择的版本添加到package.json的resolutions字段中。
yarn install --production：在生产环境中，此命令将忽略devDependencies，只安装生产所需的依赖，加快安装速度并减小安装包体积。

4.2 添加和删除依赖

Yarn允许开发者灵活地管理项目依赖，包括添加和删除操作。

yarn add [package]：添加新依赖到dependencies字段。如果需要添加开发时依赖，可以使用--dev或-D标志，将依赖添加到devDependencies。
yarn remove [package]：从package.json中删除指定的依赖，并清理node_modules目录中对应的文件。

4.3 其他常用命令

除了基本的依赖管理，Yarn还提供了一些其他提高开发效率的命令。

yarn upgrade [package]：升级指定的依赖包到最新版本。如果使用yarn upgrade --latest，则升级所有包到最新版本。
yarn upgrade-interactive：交互式升级依赖，允许开发者选择要升级的依赖版本。
yarn run [script]：运行在package.json的scripts字段定义的脚本。例如，yarn run test可以运行测试脚本。
yarn global add [package]：将包安装到全局，使其在任何项目中都可用。
yarn cache clean：清理Yarn缓存，释放磁盘空间。在升级Yarn或解决某些安装问题时，这个命令可能会用到。

通过这些命令，Yarn为JavaScript项目的依赖管理提供了强大而灵活的工具，帮助开发者更高效地进行开发和维护。

5. npm与Yarn命令比较

5.1 依赖版本控制差异

Yarn 和 npm 在依赖版本控制方面有显著的不同。Yarn 引入了 yarn.lock 文件，该文件记录了项目依赖的确切版本，确保了在不同开发环境中安装的依赖版本一致性。这避免了 npm 中常见的版本冲突问题，因为 npm 通常依赖于 package.json 中的语义化版本号，这可能导致在不同时间安装依赖时获取到的版本不一致。

Yarn: 使用 yarn.lock 文件锁定依赖版本，确保在所有环境中的一致性。
npm: 依赖于 package.json 中的语义化版本号，可能在不同时间安装时获取不同版本。

5.2 命令使用差异

Yarn 和 npm 的命令使用也存在一些差异，这些差异体现在安装依赖、添加依赖、更新依赖等方面。

安装依赖:
- Yarn: 使用 yarn install 命令安装依赖，并且默认生成 yarn.lock 文件。
- npm: 使用 npm install 命令安装依赖，可以通过 npm install --package-lock-only 来生成 package-lock.json 文件。
添加依赖:
- Yarn: 使用 yarn add [package] 命令添加依赖，并更新 yarn.lock 文件。
- npm: 使用 npm install [package] 命令添加依赖，并更新 package-lock.json 文件。
更新依赖:
- Yarn: 使用 yarn upgrade [package] 命令更新依赖，同时保持 yarn.lock 文件的一致性。
- npm: 使用 npm update [package] 命令更新依赖，同时更新 package-lock.json 文件。
移除依赖:
- Yarn: 使用 yarn remove [package] 命令移除依赖，并更新 yarn.lock 文件。
- npm: 使用 npm uninstall [package] 命令移除依赖，并更新 package-lock.json 文件。
全局安装:
- Yarn: 使用 yarn global add [package] 命令全局安装依赖。
- npm: 使用 npm install -g [package] 命令全局安装依赖。

这些命令使用上的差异反映了 Yarn 和 npm 在设计理念和使用习惯上的不同，开发者可以根据个人喜好和项目需求选择合适的包管理工具。

6. 检查Yarn安装

6.1 验证安装是否成功

安装完成后，需要验证Yarn是否安装成功。可以通过在终端或命令提示符中执行以下命令来检查：

yarn --version

如果终端输出了Yarn的版本号，这表明Yarn已经成功安装在您的系统上。

6.2 检查Yarn的全局安装路径

Yarn的全局安装路径可以通过以下命令查看：

yarn global dir

该命令将显示Yarn全局安装包的路径，确保您知道Yarn包被安装在哪里。

6.3 检查Yarn的配置信息

使用以下命令可以查看Yarn的所有配置信息，包括镜像源、缓存路径等：

yarn config list

这个命令会列出当前Yarn的配置，您可以检查是否已经按照您的需求进行了相应的配置。

6.4 检查Yarn的依赖管理

Yarn使用yarn.lock文件来锁定依赖项的版本，确保在不同环境中的依赖一致性。您可以检查项目根目录下是否存在yarn.lock文件：

ls yarn.lock

如果存在，说明依赖项已经被锁定，这有助于团队协作和持续集成流程中的稳定性。

6.5 检查Yarn的插件和扩展

Yarn支持插件系统，可以通过以下命令查看已安装的插件：

yarn plugins list

如果列出了插件，说明Yarn已经配置了额外的功能扩展，可以根据需要使用这些插件来增强Yarn的功能。

7. 升级Yarn

升级Yarn是确保你能够使用最新功能和安全更新的重要步骤。Yarn会定期发布新版本，包括性能改进、新特性以及安全修复。

7.1 升级方法

升级Yarn的主要方法有两种：通过npm和使用Yarn自己的命令。

通过npm升级：由于Yarn是通过npm安装的，因此可以使用npm命令来升级Yarn到最新版本。
```
npm install -g yarn
```
使用Yarn升级：如果系统中已经安装了Yarn，可以使用Yarn提供的命令来升级自身。
```
yarn set version latest
yarn install
```

7.2 升级注意事项

在升级Yarn之前，需要注意以下几点：

备份：在升级之前，建议备份你的项目和全局配置，以防万一升级过程中出现问题。
检查依赖：升级Yarn可能会影响你的项目依赖，确保在升级后重新运行yarn install来安装最新的依赖版本。
测试：在生产环境中升级之前，建议在开发或测试环境中先进行升级，确保新版本不会影响现有功能。

7.3 升级流程

升级Yarn的一般流程如下：

查看当前版本：使用命令yarn --version来查看当前Yarn的版本。
获取最新版本：通过上述任一方法获取Yarn的最新版本。
验证安装：升级完成后，再次使用yarn --version来验证是否升级成功。
更新项目依赖：运行yarn install来确保所有依赖都是最新的，并且与新版本的Yarn兼容。

7.4 升级后的验证

升级后，可以通过以下方式验证Yarn是否正常工作：

运行项目：尝试运行你的项目，确保一切正常运行。
检查依赖：查看package.json和yarn.lock文件，确保所有依赖都已正确安装。
使用Yarn命令：尝试使用一些常用的Yarn命令，如yarn add、yarn remove等，以确保命令行工具的功能正常。

通过上述步骤，你可以确保Yarn的升级过程顺利，并且不会影响你的开发工作。

如果这篇文章对你有所帮助，欢迎点赞、分享和留言，让更多的人受益。感谢你的细心阅读，如果你发现了任何错误或需要补充的地方，请随时告诉我，我会尽快处理。