将多阶段Docker构建从Yarn 1升级至Yarn 4的问题咨询

先直接给出适配Yarn 4的完整Dockerfile，再逐个解决你遇到的问题：

# 依赖安装阶段
FROM node:20-alpine AS dependencies
WORKDIR /app
# 复制Yarn配置和依赖清单
COPY package.json yarn.lock .yarnrc.yml ./
COPY .yarn/releases ./.yarn/releases
COPY .yarn/plugins ./.yarn/plugins

# 挂载缓存加速安装，--immutable确保依赖版本锁定
RUN --mount=type=cache,target=/root/.yarn \
    YARN_CACHE_FOLDER=/root/.yarn yarn install --immutable --production=false

# 构建阶段
FROM node:20-alpine AS builder
WORKDIR /app
# 复制依赖阶段的Yarn环境和依赖信息
COPY --from=dependencies /app/.yarn ./.yarn
COPY --from=dependencies /app/.pnp.cjs ./
COPY --from=dependencies /app/.pnp.loader.mjs ./
COPY --from=dependencies /app/package.json ./
COPY --from=dependencies /app/yarn.lock ./
COPY --from=dependencies /app/.yarnrc.yml ./

# 复制项目源码
COPY . .

# 用项目依赖的TypeScript执行构建（需提前把typescript@5.5.4加到devDependencies）
RUN yarn build

# 运行阶段
FROM node:20-alpine AS runner
WORKDIR /app
# 复制运行必需的Yarn文件和依赖信息
COPY --from=dependencies /app/.yarn/releases ./.yarn/releases
COPY --from=dependencies /app/.yarn/plugins ./.yarn/plugins
COPY --from=dependencies /app/.pnp.cjs ./
COPY --from=dependencies /app/.pnp.loader.mjs ./
COPY --from=dependencies /app/package.json ./
COPY --from=dependencies /app/yarn.lock ./
COPY --from=dependencies /app/.yarnrc.yml ./

# 复制构建产物和启动脚本
COPY --from=builder /app/build ./build
COPY entrypoint.js ./
COPY .env ./

# 用Yarn的PnP loader启动应用
ENTRYPOINT ["node", "--require", "./.pnp.cjs", "entrypoint.js"]

接下来逐个解决你的疑问：

1. Yarn 4无node_modules目录的多阶段构建方案 #

Yarn 4默认采用PnP（Plug'n'Play）模式，确实不会生成node_modules，但多阶段构建依然有意义——可以在依赖阶段完成所有依赖安装，后续阶段只复制必需的PnP相关文件，避免重复下载依赖。

需要复制的核心文件包括：

• .pnp.cjs、.pnp.loader.mjs：PnP的核心加载器文件
• .yarn/releases：Yarn的版本包
• .yarn/plugins：Yarn使用的插件（比如@yarnpkg/plugin-typescript）
• package.json、yarn.lock、.yarnrc.yml：依赖清单和Yarn配置

不需要复制.yarn/cache，因为缓存只在构建阶段有用，运行时不需要。

2. Yarn 4不支持全局安装TypeScript的替代方案 #

有两种常用方案：

• 方案一：将TypeScript添加到项目devDependencies
  在package.json的devDependencies中添加typescript@5.5.4，然后直接用yarn build（前提是你的build脚本已经配置为tsc），Yarn会通过PnP自动找到tsc的执行路径。
• 方案二：用yarn dlx临时运行指定版本的TypeScript
  如果不想把TypeScript加到项目依赖里，可以在构建阶段直接执行：

  yarn dlx typescript@5.5.4 --project ./tsconfig.json
  

  dlx会临时下载指定版本的包并执行其命令，适合一次性使用的场景。

3. Yarn命令缓存的影响 #

使用--mount=type=cache,target=/root/.yarn是构建阶段的缓存，这个缓存目录不会被打包到最终的镜像里，只会在构建过程中复用已下载的依赖包，加速构建速度。

清理Docker缓存目录只会影响下一次构建（需要重新下载依赖），完全不会影响已经构建好的镜像运行——因为镜像里根本不包含这个缓存目录，运行时依赖的是PnP加载器和依赖清单，和构建缓存无关。

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