Docker化NodeJS应用：如何保留node_modules并优化构建顺序？

先执行 npm ci 确实更优 #

这是Docker构建的最佳实践之一：Docker基于分层缓存机制工作，先复制package*.json再执行npm ci，只要你的依赖配置文件（package.json、package-lock.json）没改动，Docker就会直接复用这一层的缓存，无需重新下载安装依赖，能大幅缩短构建时间。如果先复制全部代码再执行npm ci，任何业务代码的小改动都会触发全量依赖重装，完全浪费了缓存的优势。

如何保留容器内的 node_modules #

你遇到的COPY . .覆盖node_modules的问题，核心是本地的node_modules被复制进容器，替换了容器内通过npm ci生成的版本，解决只需两步：

1. 配置 .dockerignore 文件
   在项目根目录的.dockerignore中添加node_modules，让Docker执行COPY . .时跳过本地的依赖文件夹：

node_modules
.git
.env
# 可补充其他需要忽略的文件/目录

2. 使用最优顺序的Dockerfile
   保持先装依赖再复制代码的逻辑，示例如下：

FROM node:18-alpine

WORKDIR /app

# 先复制依赖配置文件，触发缓存
COPY package*.json ./

# 用npm ci安装与lock文件完全匹配的依赖
RUN npm ci

# 复制项目代码（此时本地node_modules已被忽略，不会覆盖容器内的版本）
COPY . .

EXPOSE 3000

CMD ["node", "server.js"]

这样既保证了依赖安装的缓存效率，又能让容器内的node_modules完整保留，不会被本地文件覆盖。

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