Yarn 4.x 必须通过 Node.js 16.10+ 内置的 corepack 启用，禁用 npm install -g 或系统包管理器安装；需配置国内镜像源并清除旧版 Yarn。
Yarn 在 Linux 上不能独立安装，必须先有 Node.js；但具体怎么装、装哪个版本、用什么方式，取决于你用的 Yarn 版本（3.x 还是 4.x）和发行版类型。直接上结论：如果你刚配开发环境，优先用 corepack 启用 Yarn 4.x，别碰全局 yarn install -g —— 它在新版本里已废弃且容易冲突。
Node.js 必须先装，且版本不能低于 16.10
Yarn 4 依赖 Node.js 内置的 corepack，而 corepack 是从 Node.js 16.10 开始默认内置的。低于这个版本（比如 Ubuntu 22.04 自带的 v12.22 或 CentOS 7 的 v10.24），corepack enable 会报错或静默失效。
- 查当前版本：
node -v，若输出v14.x或更低，必须升级 - 推荐装官方 LTS：去 nodejs.org/zh-cn 下载
.tar.xz包解压到/opt/nodejs，再用软链接注入/usr/local/bin - 别用系统包管理器（如
apt install nodejs）装旧版 Node —— 它常带阉割版 npm 和缺失corepack - 验证
corepack是否可用：corepack --version，无输出或报 command not found 就说明 Node 版本不够或未启用
yarn 4.x 必须通过 corepack 启用，不是 npm install -g
Yarn 4 不再提供独立二进制包，也不接受 npm install -g yarn。强行这么装，会导致 yarn --version 显示 1.x 或 3.x，后续 yarn set version 失败，且与项目中 .yarnrc.yml 冲突。
- 启用 corepack：
corepack enable（需 root 权限时加sudo） - 设置项目级 Yarn 版本（推荐）：
yarn set version stable（自动写入.yarn目录和.yarnrc.yml） - 全局设默认版本（可选）：
yarn set version berry，然后corepack prepare yarn@stable --activate - 检查生效：
yarn --version应输出4.x.x，且yarn -v和yarn --version结果一致
国内用户必须配镜像源，否则 yarn install 卡死或 404
Yarn 4 默认 registry 是 https://registry.yarnpkg.com，国内直连基本不可用。不配镜像，yarn install 会卡在 “Resolving packages…” 或报 HTTPError: Response code 404（尤其访问 scoped package 时）。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
立即学习“前端免费学习笔记（深入）”；
- 设 npmmirror 镜像（淘宝源已全量迁移）：
yarn config set registry https://registry.npmmirror.com - 验证是否写入：
yarn config get registry，输出应为上面的 URL - 如果项目用了
.yarnrc.yml，该配置会被覆盖，需在文件里显式写：npmRegistryServer: "https://registry.npmmirror.com" - 注意：
yarn config设置的是全局配置，对所有项目生效；但.yarnrc.yml优先级更高，修改后记得yarn install重拉 lockfile
apt/yum 安装的 yarn 二进制是过时的 1.x，别用
Debian/Ubuntu 的 apt install yarn、Rocky/CentOS 的 yum install yarn，装出来都是 Yarn 1.x（Classic）。它不支持 Plug'n'Play（PnP）、.yarnrc.yml、yarn set version，和现代前端工具链（Vite、Turborepo、Next.js 14+）根本不兼容。
- 卸载它：
sudo apt remove yarn或sudo yum remove yarn - 删残留：
which yarn看路径，手动删掉/usr/bin/yarn或/usr/local/bin/yarn - 确认清空：
yarn --version报 command not found 才算干净 - 之后再走
corepack流程，别回头
真正麻烦的不是安装步骤，而是旧文档和搜索引擎结果还在推 npm install -g yarn 或 apt install yarn。Yarn 4 的设计哲学是“项目自包含”，yarn 命令本身由 corepack 按项目需求动态加载，所以全局装一个二进制毫无意义——反而会锁死版本、污染 PATH、干扰 PnP 加载逻辑。
