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

后端开发 2026-07-10

我有一个基于node:20-alpine的 Docker镜像，已经把Node升级到了：

我正在尝试更新我的Dockerfile，以使用 node:25-alpine。在以前的Node版本中，我只需要运行 apk add yarn 就能使用Yarn Berry（3.6.1）。

然而，在Node 25中，yarn已经安装，但版本过旧。Corepack不再默认包含，因此我无法靠它轻松更新。当我尝试通过 npm install -g corepack 手动安装时，即使我没有通过apk安装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

如何正确配置一个 node:25-alpine 镜像，使其全局使用Yarn 3.6.1？

解决方案

从Node 25开始，Corepack已与Node.js二进制发行版解耦。此外，官方的Docker镜像仍然包含一个旧的Yarn 1.x二进制，在尝试手动安装Corepack时会导致冲突，因此安装Corepack失败。而且，你也无法通过apk卸载那个yarn版本。这真是一团糟。

为了解决这个问题，必须强制Corepack安装覆盖旧的二进制文件，然后使用Corepack来准备并激活你指定的Yarn版本：

FROM node:25-alpine

# 1. Install corepack and force-overwrite the existing Yarn 1.x shims
# 2. Enable the corepack shims
# 3. Activate your specific version globally
RUN npm install -g corepack@latest --force && \
    corepack enable && \
    corepack prepare [email protected] --activate

installation