如何在Docker中让npm配合旧版本Node（14.10.0）使用？

核心原因 #

nvm并非全局可执行文件，而是shell函数，默认的非交互式shell（CMD/ENTRYPOINT默认使用的环境）不会自动加载nvm的初始化脚本，导致直接调用nvm命令时提示找不到。

解决方案1：在CMD中手动加载nvm初始化脚本 #

修改CMD指令，先加载nvm的初始化脚本（通常路径为~/.nvm/nvm.sh），再切换版本并执行应用命令：

ENV NODE_VERSION 14.10.0
# 构建时安装并验证版本
RUN nvm install $NODE_VERSION && nvm use $NODE_VERSION && npm show node version
RUN nvm -v

# 启动时加载nvm脚本、切换版本、启动应用
CMD ["/bin/bash", "-c", "source ~/.nvm/nvm.sh && nvm use $NODE_VERSION && npm start"]

注意：必须使用/bin/bash而非/bin/sh，因为nvm的初始化脚本依赖bash特性。

解决方案2：设置nvm默认版本（更简洁） #

在构建阶段将目标Node版本设为nvm默认版本，启动容器时无需手动切换，直接使用npm命令即可：

ENV NODE_VERSION 14.10.0
RUN nvm install $NODE_VERSION
# 设置该版本为默认
RUN nvm alias default $NODE_VERSION
# 验证默认版本
RUN node -v && npm -v

# 启动时直接执行npm命令，默认使用指定版本
CMD ["npm", "start"]

解决方案3：放弃nvm，直接使用官方指定版本镜像 #

如果不需要多版本切换，最省心的方式是直接基于官方Node镜像的指定版本构建，无需nvm：

# 直接使用Node 14.10.0官方镜像，内置对应版本的npm
FROM node:14.10.0

# 后续步骤：复制代码、安装依赖、启动应用
COPY . /app
WORKDIR /app
RUN npm install
CMD ["npm", "start"]

这种方式完全避免nvm的环境问题，是Docker中运行Node应用的标准做法。

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