yarn 可通过 apt、npm 全局安装或官方脚本三种方式安装，推荐 apt 方式（稳定无 node.js 依赖）；安装后需配置国内镜像源（如 npmmirror）及可选缓存/全局目录以优化体验。

如果您在 Linux 系统中需要使用 Yarn 包管理器，但尚未安装，则可能是由于系统未预装或 Node.js 环境缺失导致无法直接调用 yarn 命令。以下是多种可行的安装与基础配置步骤：

一、通过 APT 包管理器安装（适用于 Debian/Ubuntu）

该方法利用系统原生软件源安装官方维护的 Yarn 二进制包，无需依赖 Node.js 全局 npm，安装后可直接使用，适合追求稳定性和最小依赖的用户。

1、导入 Yarn 官方 GPG 密钥：
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -

2、添加 Yarn 官方 APT 仓库源：
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

3、更新软件包索引：
sudo apt update

4、安装 Yarn：
sudo apt install yarn

5、验证安装结果：
yarn --version

二、使用 npm 全局安装（需已安装 Node.js 和 npm）

该方式将 Yarn 作为 npm 包进行全局部署，适用于已配置好 Node.js 开发环境的用户，灵活性高且版本更新及时。

1、确认 Node.js 已安装：
node -v

2、确认 npm 已安装：
npm -v

3、执行全局安装命令：
sudo npm install -g yarn

4、检查是否写入 PATH：若提示 command not found: yarn，需手动配置环境变量（见后续步骤）

5、验证安装：
yarn --version

三、运行官方安装脚本（跨发行版通用）

此方法由 Yarn 官方提供，自动检测系统架构并下载对应二进制文件，解压至 ~/.yarn/bin 目录，不依赖系统包管理器，兼容性最广。

1、执行一键安装脚本：
curl -o- -L https://yarnpkg.com/install.sh | bash

2、脚本执行完成后，会提示类似以下路径：
~/.yarn/bin

3、将该路径加入当前 shell 配置文件：
echo 'export PATH="$HOME/.yarn/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

4、验证是否生效：
yarn --version

四、配置国内镜像源提升下载速度

Yarn 默认连接国外 registry，国内用户常因网络延迟导致 install 超时或失败，设置淘宝或 npmmirror 镜像源可显著改善依赖获取效率。

1、设置淘宝 registry（已迁移至 npmmirror）：
yarn config set registry https://registry.npmmirror.com

2、验证配置是否写入：
yarn config get registry

3、预期返回值应为：https://registry.npmmirror.com

五、配置全局缓存与安装目录（可选进阶）

默认情况下 Yarn 将缓存和全局包混存在用户主目录下，统一指定路径有利于磁盘空间管理和多用户隔离。

1、创建自定义缓存目录：
mkdir -p ~/.yarn/cache

2、设置缓存路径：
yarn config set cache-folder ~/.yarn/cache

3、创建全局模块安装目录：
mkdir -p ~/.yarn/global

4、设置全局 prefix：
yarn config set prefix ~/.yarn/global

5、将全局 bin 加入 PATH（如未包含）：
echo 'export PATH="$HOME/.yarn/global/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc