MacOS 上配置 Corepack 与 Yarn 的核心是启用 Node.js 内置 Corepack（v16.13+默认内置但需手动启用），通过 corepack enable 激活，再用 .yarnrc.yml 指定 yarnPath 并执行 corepack prepare 下载对应版本，实现项目级 Yarn 版本锁定与安全复现。
MacOS 系统上配置 Corepack 与 Yarn，核心在于启用 Node.js 自带的 Corepack（无需全局安装 Yarn），并确保其能正确管理 Yarn 版本。这比传统 npm install -g yarn 更安全、更可复现。
确认 Node.js 版本并启用 Corepack
Corepack 自 Node.js v16.13+ 起默认内置，但默认处于禁用状态。先检查当前 Node 版本：
node -v若为 v16.13 或更高（推荐 v18.17+ / v20.9+），运行以下命令启用 Corepack：
corepack enable该命令会将 corepack 可执行文件软链接到 /usr/local/bin/corepack（或 Homebrew Node 对应路径），同时让 yarn 和 pnpm 命令在终端中可用。
立即学习“前端免费学习笔记（深入）”；
为项目指定 Yarn 版本（通过 .yarnrc.yml）
Corepack 不自动下载 Yarn，而是根据项目根目录下的 .yarnrc.yml 中的 yarnPath 或全局 enableGlobalCache + defaultLanguageName 等配置决定行为。推荐方式是显式声明版本：
- 在项目根目录创建 .yarnrc.yml
- 写入：
yarnPath: ".yarn/releases/yarn-4.3.1.cjs" - 然后运行 corepack prepare yarn@4.3.1 --activate，它会自动下载对应版本到 .yarn/releases/ 并激活
这样每个项目可锁定不同 Yarn 版本，避免团队间工具不一致问题。
验证与日常使用
执行以下命令确认配置生效：
- yarn --version → 应输出你设定的版本（如 4.3.1）
- which yarn → 应指向 /usr/local/bin/yarn（由 corepack 注入的代理脚本）
- yarn set version stable → 可快速切换到最新稳定版（Yarn 4.x）
后续所有 yarn install、yarn dev 等命令均走 Corepack 管理的 Yarn 实例，无需额外配置 shell profile。
常见问题处理
若遇到 command not found: yarn：
- 检查是否执行过 corepack enable；未执行则补上
- 重启终端或运行 source ~/.zshrc（或你的 shell 配置文件）
- Homebrew 安装的 Node 用户，确保 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）在 $PATH 前置位置
若 yarn --version 报错 “Cannot find module …”：说明 yarnPath 指向的文件不存在，重新运行 corepack prepare 即可。
