构建Docker镜像时.dockerignore未忽略node_modules问题求助

核心事实 #

你在容器里看到的node_modules不是本地目录里的那个——它是RUN npm install命令在容器内部执行时，根据package.json安装依赖生成的文件夹，和本地的node_modules完全无关。

你的.dockerignore已经生效了 #

你的.dockerignore配置没问题，本地的node_modules并没有被COPY . .复制到容器中。可以通过以下步骤验证：

• 在本地node_modules目录下创建一个自定义文件，比如local-only-file.txt
• 重新构建镜像并进入容器
• 查看容器内/app/node_modules/local-only-file.txt，会发现这个文件不存在，证明本地的node_modules确实被忽略了。

为什么容器里会有node_modules #

你的Dockerfile执行流程导致了这个结果：

1. COPY package.json .：把本地的package.json复制到容器的/app目录
2. RUN npm install：在容器内部执行安装命令，自动生成/app/node_modules
3. COPY . .：把本地除了.dockerignore排除项（本地node_modules）之外的文件复制到容器

如果你想避免容器中出现node_modules（一般不推荐） #

如果你的项目是编译型的（比如React、Vue），可以使用多阶段构建，只把编译后的静态文件复制到最终镜像，不需要保留node_modules。示例Dockerfile如下：

# 构建阶段
FROM node:20.6.0-alpine AS builder
WORKDIR /app
COPY package.json .
RUN npm install
COPY . .
RUN npm run build # 执行编译命令，生成dist目录

# 最终镜像阶段
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

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