安装

在开始使用 Yarn 之前,你需要先安装它。这里有很多种安装方法:

从上述列表中选择你所使用的平台

macOS

Homebrew

你可以通过 Homebrew 包管理工具安装 Yarn。 如果你还未安装 Node.js,Homebrew 会自动为你安装。

brew update
brew install yarn

设置路径

你需要设置你终端的 PATH 环境变量,以便全局访问 Yarn 的可执行文件。

添加 export PATH="$PATH:`yarn global bin`" 到你的 profile 文件(也可能是 .profile.bashrc.zshrc 等文件)。

Windows

在 Windows 上有 2 种方式来安装 Yarn。

下载安装程序

你可以下载一份 .msi 文件,运行之后将引导你完成 Yarn 的安装。

如果你使用安装程序的方式,你需要首先安装 Node.js.

下载安装程序

通过 Chocolatey 安装

Chocolatey 是一个针对 Windows 平台的包管理工具,你可以根据 这份说明首先安装 Chocolatey 。

安装 Chocolatey 之后,你就可以通过如下指令安装 Yarn 了:

choco install yarn

这种安装方式也要求你必须事先安装好 Node.js

注意

请首先将项目目录和 Yarn 的缓存目录(%LocalAppData%\Yarn)加入到杀毒软件中白名单中,否则由于每次往硬盘上写一个文件都要被扫描一次,会非常影响安装速度。

Debian/Ubuntu Linux

在 Debian 或者 Ubuntu 操作系统上,你可以通过我们提供的 Debian 包仓库来安装 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

在 Ubuntu 14.04 和 Debian 稳定版中,你还需要配置 NodeSource 仓库 来获取新版本的 Node.js (Debian 测试版和 Ubuntu 16.04 版本中已经集成了一个足够新的 Node.js 版本,所以在这些环境中可以跳过这步)。

然后执行:

sudo apt-get update && sudo apt-get install yarn

CentOS / Fedora / RHEL

在 CentOS、Fedora 和 RHEL 操作系统中,你可以通过我们的 RPM 包仓库来安装 Yarn。

sudo wget https://dl.yarnpkg.com/rpm/yarn.repo -O /etc/yum.repos.d/yarn.repo

如果你尚未安装 Node.js,你应该同时配置 NodeSource 仓库

curl --silent --location https://rpm.nodesource.com/setup_6.x | bash -

然后执行:

sudo yum install yarn

Arch Linux

在 Arch 操作系统上,你可以通过 AUR 来安装 Yarn。

如果你使用 yaourt 这样的 AUR 助手工具,可以简化为:

yaourt -S yarn

Solus

在 Solus 操作系统中,你可以通过 Solus 仓库来安装 Yarn。

sudo eopkg install yarn

设置路径

你需要设置你终端的 PATH 环境变量,以便全局访问 Yarn 的可执行文件。

添加 export PATH="$PATH:`yarn global bin`" 到你的 profile 文件(也可能是 .profile.bashrc.zshrc 等文件)。

Alternatives

如果你正在使用其他操作系统或者前面提供的几种方式不适用于你的操作系统,我们这里还有几种替代方案。 如果你还没有安装 Node.js 请先安装。

常见的 Linux 发行版比如 Debian, Ubuntu 和 Centos,建议通过我们的包安装 Yarn。

安装脚本

对于 macOS 和一般的 Unix 环境来说,安装 Yarn 的最简单方式是通过我们提供的安装脚本。 你可以在命令行中运行以下命令来安装 Yarn:

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

安装过程包包含校验 GPG 签名步骤: 去 GitHub 仓库查看源码

在命令行执行如下命令时还可以指定版本:

curl -o- -L https://yarnpkg.com/install.sh | bash -s -- --version [version]

这里是所有可用版本列表

利用源码包手动安装

你还可以下载源码包并解压缩到任意目录下完成安装:

cd /opt
wget https://yarnpkg.com/latest.tar.gz
tar zvxf latest.tar.gz
# Yarn 被安装在 /opt/yarn-[version]/ 目录下了

通过 npm 安装

注意: 通过 npm 安装一般是不建议的。 npm 带有不确定性,由于安装包是没有签名的,并且 npm 也不做任何完整性校验, 即便是简单的 SHA1 哈希也不校验,如果安装的是系统级的 app, 这其实隐藏了安全风险。

由于这些原因,强烈建议你选择适合你的操作系统的安装方式来安装 Yarn。

如果你的系统中已经安装了 npm 包管理器,你还可以通过 npm 来安装 Yarn, 如果你的系统中已经安装了 Node.js ,也就必定安装了 npm。

如果 npm 已经安装,请执行:

npm install --global yarn

路径设置

Unix/Linux/macOS

你需要设置你终端的 PATH 环境变量,以便全局访问 Yarn 的可执行文件。

添加 export PATH="$PATH:`yarn global bin`" 到你的 profile 文件(也可能是 .profile.bashrc.zshrc 等文件)。

Windows

你需要设置你终端的 PATH 环境变量,以便全局访问 Yarn 的可执行文件。

执行 set PATH=%PATH%;C:\.yarn\bin 来重新设置环境。

测试一下 Yarn 是否能够正确运行:

yarn --version

每日构建版

每日构建版(Nightly builds)是 Yarn 的最新、最好的版本,是基于最新的源码构建的。 每日构建版对于尝试 Yarn 的新特性或者测试 bug 修复情况非常有用。 然而,这种版本 不保证是稳定的 而且还可能有 bug。

查看如何安装每日构建版


有问题? 如果你使用上述安装方法都不能成功安装 Yarn,请在 GitHub 上搜索已经被提交的 issue,如果没有,你可以提交一个新 issue。

搜索已存在的 issue · 提交一个新 issue