macOS 安装卸载升级 Yarn

安装 Yarn

使用 Homebrew 安装 Yarn：

brew install yarn --ignore-dependencies

查看安装的 Yarn 版本：

yarn -v

1.17.3

查看 Yarn 全局 bin 路径：

yarn global bin

/usr/local/bin

查看当前用户的环境变量中的 $PATH ：

echo $PATH

/usr/local/opt/node@10/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

可见 Yarn 全局 bin 路径在其中，不需要设置。

如果不在其中，则需要手动添加路径至 Zsh 配置文件 ~/.zshrc 中：

echo 'export PATH="$PATH:`yarn global bin`"' >> ~/.zshrc
source ~/.zshrc

Tips: 如果使用的是 macOS 默认的 bash，则配置文件为 ~/.bash_profile 。

切换 Yarn 源

手动切换 Yarn 源

常见 Node.js 软件源：

# npm（推荐海外使用）
https://registry.npmjs.org/

# taobao（推荐国内使用）
https://registry.npm.taobao.org/

手动切换 Yarn 源，如切换至 taobao 镜像源 ：

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

查看设置之后的 Yarn 源配置：

yarn config get registry

https://registry.npm.taobao.org/

使用 yrm 切换 Yarn 源

全局安装 yrm ：

sudo yarn global add yrm

列出 yrm 支持的源：

yrm ls

• npm ---- https://registry.npmjs.org/

  cnpm --- http://r.cnpmjs.org/

  taobao - https://registry.npm.taobao.org/

  nj ----- https://registry.nodejitsu.com/

  rednpm - http://registry.mirror.cqupt.edu.cn/

  npmMirror https://skimdb.npmjs.com/registry/

  edunpm - http://registry.enpmjs.org/

  yarn --- https://registry.yarnpkg.com

测试各个源的连接速度：

yrm test

• npm ---- 494ms

  cnpm --- 311ms

  taobao - 110ms

  nj ----- Fetch Error

  rednpm - Fetch Error

  npmMirror 1583ms

  edunpm - Fetch Error

  yarn --- Fetch Error

切换至速度最快的的源，如 taobao：

yrm use taobao

卸载 Yarn

查看当前所有已安装软件包依赖树：

brew deps --installed --tree

icu4c

node@10 └── icu4c

yarn └── node └── icu4c

可见有共享依赖 icu4c ，只卸载 Yarn 软件包：

brew uninstall yarn

升级 Yarn

更新 Homebrew：

brew update

卸载并重装 Yarn 完成升级：

brew uninstall yarn && brew install yarn --ignore-dependencies

Tips: 使用brew upgrade yarn 会强制安装最新版 node，且该命令不支持 --ignore-dependencies 参数，只能卸载了重装。

常见问题

安装失败

错误信息

如果 Node.js 是使用 Homebrew 安装的非最新版本，比如 node@12 ，后续使用 Homebrew 安装 Yarn 即使使用了 --ignore-dependencies 参数依然可能会安装失败：

...... Error: An exception occurred within a child process: RuntimeError: /usr/local/opt/node not present or broken Please reinstall node. Sorry :(

解决办法

手动建立软链：

ln -s /usr/local/opt/node@12 /usr/local/opt/node

再重新安装：

brew install yarn --ignore-dependencies

找不到命令

错误信息

macOS 上使用 Homebrew 安装的 Yarn，可能会偶然出现找不到命令的情况（之前正常）：

zsh: command not found: yarn

使用 Homebrew 查看安装的软件列表，发现安装的有 Yarn：

brew list

gettext git gradle icu4c node@12 pcre2 yarn

解决办法

重新建立一次 Yarn 命令的软链即可：

brew unlink yarn && brew link yarn

参考文献

• 安装 Yarn