Docker build 命令（手把手讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在容器化技术蓬勃发展的今天，Docker 已成为开发和运维人员的必备工具。而 Docker build 命令作为构建容器镜像的核心工具，是掌握 Docker 技术体系的关键一步。无论你是编程初学者，还是希望提升容器化技能的中级开发者，理解 Docker build 的工作原理和使用场景，都能显著提升开发效率和部署可靠性。本文将通过循序渐进的方式，结合实际案例，带你全面掌握 Docker build 命令的使用方法与最佳实践。

Docker build 命令的基础语法

1. 命令结构与核心参数

Docker build 的基本语法如下：

docker build [OPTIONS] PATH | URL | -  

其中：

• PATH：指定包含 Dockerfile 的目录路径（可以是本地路径或 Git 仓库地址）。
• URL：直接从远程仓库拉取 Dockerfile。
• -：从标准输入读取 Dockerfile 内容。

2. 核心参数详解

示例：构建并标记镜像

docker build -t my-python-app:v2 .  

Dockerfile：Docker build 的“菜谱”

Docker build 命令的核心依赖是 Dockerfile，它是一个文本文件，包含一系列指令，指导 Docker 如何构建镜像。可以将其想象为烹饪菜谱：

• 基础镜像（FROM）：如同选择食材，定义构建的起点。
• 指令（RUN, COPY 等）：相当于烹饪步骤，逐步配置环境。
• 最终目标（CMD/ENTRYPOINT）：决定容器启动时的行为，如同菜谱的最终成品。

典型 Dockerfile 结构示例

FROM python:3.9-slim  

WORKDIR /app  

COPY requirements.txt .  

RUN pip install -r requirements.txt  

COPY . .  

CMD ["python", "app.py"]  

关键指令解析

1. FROM：必须以 FROM 开头，指定基础镜像（如 ubuntu、nginx）。
2. RUN：执行命令（如安装软件、编译代码）。
3. COPY：将本地文件复制到镜像中。
4. CMD：定义容器启动时的默认命令（可被运行时参数覆盖）。

Docker build 的工作原理与缓存机制

1. 分层构建与镜像层

Docker 镜像由多个只读层叠加而成，每次 Docker build 会按顺序执行 Dockerfile 中的指令，并为每一步生成一个新层。例如：

• FROM python:3.9-slim 对应基础层。
• COPY requirements.txt . 生成包含依赖文件的新层。

2. 构建缓存机制

Docker 会自动缓存已执行的步骤，避免重复耗时操作。例如：

• 如果 RUN pip install ... 后未修改 requirements.txt，后续构建会直接复用已缓存的依赖安装结果。

缓存失效的场景

• 修改 Dockerfile 中的 RUN 指令内容。
• 更新 COPY 的源文件（如修改代码后重新构建）。

如何绕过缓存？

使用 --no-cache 参数强制重新构建所有步骤：

docker build --no-cache -t my-app:latest .  

进阶用法：多阶段构建与轻量镜像

1. 多阶段构建（Multi-Stage Builds）

传统构建可能面临镜像体积过大、安全风险高的问题。多阶段构建通过分阶段构建，仅保留必要文件，显著优化镜像。

案例：构建一个轻量级 Python 应用

FROM python:3.9-slim AS builder  
WORKDIR /app  
COPY requirements.txt .  
RUN pip install -r requirements.txt --target=./app  

FROM python:3.9-slim  
WORKDIR /app  
COPY --from=builder /app/app .  
CMD ["python", "app.py"]  

比喻：这如同装修房屋，第一阶段“工人”（构建环境）完成复杂工作（安装依赖），第二阶段“入住者”（运行环境）仅保留干净的家具（应用文件）。

2. 最佳实践

• 最小化基础镜像：优先选择 *-slim 或 *-alpine 版本（如 python:3.9-slim）。
• 按顺序优化指令：将不常变动的指令放在前面，减少缓存失效的频率。

常见问题与解决方案

1. 构建失败：权限或路径错误

场景：复制文件时提示“权限不足”或“文件未找到”。
解决：

• 检查本地文件路径是否正确。
• 在 Dockerfile 中使用 RUN chmod 调整文件权限。

2. 镜像体积过大

解决：

• 使用多阶段构建（如上例）。
• 合并 RUN 指令，减少层数：

  RUN apt-get update && apt-get install -y package1 package2 && rm -rf /var/lib/apt/lists/*  
  

3. 网络或依赖问题

场景：构建时因网络波动或依赖缺失失败。
解决：

• 在 RUN 指令中添加重试逻辑（如 apt-get update || apt-get update）。
• 使用 --network host 临时启用主机网络（需谨慎）。

实战案例：构建一个 Nginx Web 服务器

步骤 1：编写 Dockerfile

FROM nginx:latest  

COPY ./public-html/ /usr/share/nginx/html/  

EXPOSE 80  

CMD ["nginx", "-g", "daemon off;"]  

步骤 2：执行构建

docker build -t my-nginx:v1 .  

docker run -d -p 80:80 my-nginx:v1  

验证结果

访问本地 http://localhost，应显示自定义的 HTML 内容。

结论

通过本文，我们系统学习了 Docker build 命令的核心概念、语法、实践案例和优化技巧。从基础的 Dockerfile 编写到多阶段构建的高级应用，每一步都强调了“构建即部署”的核心思想。掌握 Docker build 不仅能提升开发效率，还能确保应用在不同环境下的一致性。

建议读者通过以下步骤巩固知识：

1. 动手实践：基于示例修改 Dockerfile，观察构建结果。
2. 探索参数：尝试 --build-arg、--progress 等高级参数。
3. 优化镜像：使用 docker history 分析镜像层，进一步精简体积。

记住，容器化是一门需要持续实践的技术，而 Docker build 命令正是你通往自动化部署之路的关键钥匙。