Docker构建参数NODE_ENV为何会影响yarn install的包安装行为？

这不是Docker的默认设计行为。Docker的ARG参数本身不会自动成为RUN命令执行时的shell环境变量，除非你显式通过以下两种方式将其转为环境变量：

• 使用ENV NODE_ENV=${NODE_ENV}，将构建参数的值赋值给环境变量，后续所有RUN命令都会继承这个环境变量
• 在RUN命令中显式传递变量，比如RUN NODE_ENV=${NODE_ENV} yarn install

你遇到的yarn install受NODE_ENV构建参数影响的情况，大概率是以下原因之一：

• 基础镜像的特殊处理：你使用的私有镜像docker-server/docker-images/ui/node:20.10.0-alpine可能在构建时添加了逻辑，将ARG NODE_ENV自动转为容器环境变量。比如该镜像的Dockerfile中可能包含ENV NODE_ENV=${NODE_ENV}的配置，导致NODE_ENV在后续的RUN命令中生效。
• 隐式的变量传递：如果执行docker build时，你通过--build-arg NODE_ENV=$NODE_ENV（此处$NODE_ENV为主机环境变量）传递参数，且主机环境中恰好设置了NODE_ENV=production，但这种情况属于手动传递，并非Docker的默认行为。

Yarn的固有行为是：当NODE_ENV=production时，默认会以--production=true模式运行yarn install，仅安装dependencies中的包，跳过devDependencies；当NODE_ENV为其他值或未设置时，则会安装所有依赖。你添加--production=false的解决方案是有效的，它会强制Yarn忽略NODE_ENV的影响，安装全部依赖。

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