如何在node:25-alpine Docker镜像中安装指定版本Yarn（3.x/4.x）

问题背景 #

原本基于node:20-alpine镜像时，只需执行apk add yarn就能使用Yarn Berry（3.6.1）。但升级到node:25-alpine后，镜像默认预装了旧版本Yarn，且不再包含Corepack，手动执行npm install -g corepack时会因/usr/local/bin/yarn文件已存在而报错：

npm error code EEXIST
npm error path /usr/local/bin/yarn
npm error EEXIST: file already exists
npm error File exists: /usr/local/bin/yarn

解决方案 #

按以下步骤操作即可全局配置Yarn 3.6.1：

1. 移除预装的旧版Yarn文件
   先删除镜像中自带的Yarn可执行文件，避免和后续安装的Corepack管理版本冲突：

   rm -f /usr/local/bin/yarn /usr/local/bin/yarnpkg
   

2. 全局安装Corepack
   通过npm安装Corepack工具：

   npm install -g corepack
   

3. 启用Corepack并指定Yarn版本
   启用Corepack对Yarn的管理，并将全局默认Yarn版本设置为3.6.1：

   corepack enable yarn
   corepack prepare yarn@3.6.1 --activate
   

4. 验证版本（可选）
   检查Yarn版本是否正确：

   yarn --version
   

完整Dockerfile示例 #

将上述步骤整合到Dockerfile中：

FROM node:25-alpine

RUN rm -f /usr/local/bin/yarn /usr/local/bin/yarnpkg \
    && npm install -g corepack \
    && corepack enable yarn \
    && corepack prepare yarn@3.6.1 --activate

# 可选：验证Yarn版本
RUN yarn --version

说明 #

node:25-alpine预装的Yarn是独立的二进制文件，不属于Corepack管理范畴，因此必须先删除该文件才能顺利安装Corepack，之后通过Corepack来统一管理Yarn版本，确保使用指定的3.6.1版本。

内容的提问来源于stack exchange，提问作者Fabian Streitel