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

Yarn是一个快速、可靠且安全的JavaScript包管理工具，由Facebook、Google、Exponent和Tilde等公司的开发者共同维护。它旨在解决npm（Node Package Manager）在使用过程中遇到的一些性能问题，并提供更加简洁和一致的命令行接口。以下将详细介绍Yarn的安装与配置方法，以及其基本用法，帮助用户秒懂Yarn的用法。

一、安装Yarn

1. 前提条件

在安装Yarn之前，请确保您的计算机上已经安装了Node.js。Node.js为Yarn的运行提供了必要的环境支持。您可以通过在终端或命令提示符中输入node -v命令来检查Node.js是否已安装及其版本号。

2. 安装方法

Yarn的安装方法多种多样，以下是一些常用的安装方式：

2.1 使用npm安装

如果您已经安装了Node.js，那么npm（Node Package Manager）也应该已经安装在您的系统上。您可以通过npm来全局安装Yarn。在终端或命令提示符中运行以下命令：

npm install -g yarn

这个命令会将Yarn安装到您的全局npm目录中，并确保它可以在任何地方通过命令行访问。

2.2 使用安装脚本

Yarn的官方网站提供了安装脚本，您可以直接从官网下载或使用curl命令来获取安装脚本并执行它。这种方法适用于那些想要直接从Yarn官方源安装最新版本的用户。

curl -o- -L https://yarnpkg.com/install.sh | bash

请注意，使用安装脚本可能需要您拥有对系统的写权限。在某些系统上，您可能需要以管理员或root用户身份运行此命令。

2.3 使用包管理器安装

在不同的操作系统上，您还可以使用各自的包管理器来安装Yarn。

• macOS：如果您已经安装了Homebrew，可以使用以下命令安装Yarn：

  brew install yarn
  

• Windows：您可以使用Chocolatey这样的第三方包管理器来安装Yarn。首先，安装Chocolatey，然后使用以下命令安装Yarn：

  choco install yarn
  

• Linux：在基于Debian/Ubuntu的系统上，您可以使用APT包管理器来安装Yarn。首先，添加Yarn的APT仓库，然后更新包列表并安装Yarn：

  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发行版，如Fedora或CentOS，您可能需要使用不同的包管理器（如dnf或yum）来安装Yarn。

3. 验证安装

安装完成后，您可以通过在终端或命令提示符中输入yarn --version命令来验证Yarn是否已成功安装并查看其版本信息。

二、配置Yarn

Yarn允许您通过全局配置文件和项目级配置文件来自定义其行为。以下是一些常见的配置选项：

1. 全局配置

全局配置文件通常位于您的用户主目录下的.yarnrc文件中。您可以使用yarn config命令来设置或修改全局配置选项。

• 设置全局缓存目录：

  yarn config set cache-folder ~/.yarn-cache
  

  这个命令将Yarn的全局缓存目录设置为~/.yarn-cache。您可以根据需要将其更改为任何您喜欢的路径。

• 设置国内镜像源：

  由于网络原因，直接从Yarn的官方源下载包可能会很慢。为了加快下载速度，您可以设置国内镜像源，如淘宝npm镜像：

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

  或者，您也可以使用第三方工具如yrm来切换和管理镜像源。

2. 项目配置

对于特定项目，您可以在项目根目录下创建.yarnrc文件来设置项目级的Yarn配置。这些配置将仅在该项目内有效。

• 设置项目特定的Node.js版本：

  如果您的项目依赖于特定版本的Node.js，您可以在.yarnrc文件中设置nodeLinker选项来强制使用该版本的Node.js。

• 设置项目特定的镜像源：

  与全局配置类似，您也可以在项目级的.yarnrc文件中设置镜像源，以确保项目依赖的下载速度。

三、Yarn的基本用法

Yarn提供了丰富的命令行接口，用于管理项目的依赖、脚本和版本。以下是一些常用的Yarn命令及其用法：

1.#### 1. 初始化新项目

当您开始一个新项目时，可以使用yarn init命令来创建一个新的package.json文件。这个文件是Node.js项目的核心，包含了项目的元数据信息，如项目名称、版本、依赖等。

yarn init

执行该命令后，Yarn会询问您一系列问题（如项目名称、版本、描述等），您可以根据提示输入相应信息，也可以直接按回车键接受默认值。完成后，Yarn会在项目根目录下生成一个package.json文件。

2. 添加依赖

在项目开发过程中，您可能需要安装第三方库或框架作为项目的依赖。Yarn提供了add命令来添加依赖。

yarn add <package-name>

将替换为您想要添加的包名。Yarn会将该包及其依赖项添加到项目的node_modules目录，并在package.json文件的dependencies部分中添加相应的条目。

如果您想要将包作为开发依赖（即在开发过程中使用，但在生产环境中不需要）添加，可以使用--dev或-D选项。

yarn add <package-name> --dev
# 或者
yarn add <package-name> -D

3. 升级依赖

随着项目的推进，您可能需要升级项目的依赖库以获取新功能或修复bug。Yarn提供了upgrade命令来升级依赖。

yarn upgrade <package-name>

该命令会将指定的包升级到最新版本。如果省略，Yarn会尝试升级package.json中列出的所有依赖项。

4. 移除依赖

如果您不再需要某个依赖项，可以使用remove命令将其从项目中移除。

yarn remove <package-name>

Yarn会从node_modules目录中删除该包及其依赖项，并从package.json文件的dependencies或devDependencies部分中移除相应的条目。

5. 安装依赖

当您克隆了一个新项目或第一次获取了一个项目的源代码时，您可能需要安装项目的所有依赖项。Yarn提供了install命令来执行此操作。

yarn install

该命令会读取package.json文件，并根据其中列出的依赖项下载并安装它们到node_modules目录。

6. 运行脚本

在package.json文件的scripts部分，您可以定义一系列自定义脚本，这些脚本可以使用Yarn来运行。

"scripts": {
  "start": "node index.js",
  "test": "jest",
  "build": "webpack"
}

定义了脚本后，您可以使用yarn命令后跟脚本名称来运行它们。

yarn start
# 运行 `node index.js`

yarn test
# 运行 `jest`

yarn build
# 运行 `webpack`

7. 版本管理

Yarn还提供了简单的版本管理功能，允许您为项目设置版本号并管理发布。

• 设置版本号：

  yarn version --new-version <version>
  

  将替换为您想要设置的新版本号（遵循语义化版本控制规范）。Yarn会更新package.json文件中的版本号，并提示您提交这个更改到版本控制系统。

• 发布到npm：

  在设置了新的版本号后，您可以使用npm publish命令（注意，尽管Yarn管理依赖，但发布到npm仍然需要使用npm命令）将包发布到npm仓库。

  npm publish
  

  但是，Yarn也提供了一些工具来帮助您准备和发布npm包，如yarn pack命令可以创建一个包的tarball，而yarn npm login命令可以帮助您登录npm。

结论

Yarn是一个功能强大且易于使用的JavaScript包管理工具，它提供了比npm更快、更可靠的性能，以及更加简洁和一致的命令行接口。通过本文的介绍，您应该已经了解了如何安装和配置Yarn，以及如何使用Yarn来管理项目的依赖、脚本和版本。希望这些信息能帮助您更高效地开发JavaScript项目。