要重新构建 docker compose 中的指定单个服务，应使用 docker-compose build ，而非 up --build（后者默认作用于全部服务）；它仅重建目标服务镜像，不启动、不干扰其他运行中容器，轻量安全。
要重新构建 docker compose 中的指定单个服务，核心是用 docker-compose build 命令加服务名，而不是直接用 up --build（它默认作用于全部服务）。
只构建某个服务（不启动、不干扰其他容器）
这是最轻量、最安全的方式，适合开发中频繁改代码又不想重启整个栈：
-
docker-compose build <service-name></service-name>—— 仅重建该服务镜像，不影响任何正在运行的容器 - 例如：
docker-compose build api或docker-compose build web - 支持附加选项：加
--no-cache强制跳过缓存，确保完全重做；加--progress=plain查看详细构建日志
构建 + 启动/替换该服务（带配置更新）
如果修改了服务的 docker-compose.yml 配置（如端口、环境变量）或 Dockerfile，且希望立即生效，推荐组合使用：
-
docker-compose up --build -d <service-name></service-name>—— 仅对该服务重建镜像，并以 detached 模式启动（或替换已运行的同名容器） - 它会自动停止旧容器、构建新镜像、启动新容器，同时保留网络和卷挂载
- 注意：依赖该服务的其他容器不会被重建，但可能因网络连通性短暂中断（取决于应用是否重连）
验证构建结果是否生效
构建完成后，确认镜像已更新、容器运行正常：
-
docker-compose images—— 查看各服务对应镜像的 ID 和创建时间，对比确认目标服务镜像已刷新 -
docker-compose ps <service-name></service-name>—— 检查容器状态、端口映射、启动时间 -
docker-compose logs -f <service-name></service-name>—— 实时查看日志，确认启动过程无报错，加载的是新代码或新依赖
常见误区提醒
避免误操作导致整套服务重启或配置丢失：
- 别用
docker-compose up --build不带服务名 —— 它会重建所有定义了build:的服务，耗时且不必要 - 别在未保存
docker-compose.yml修改前就执行up --build <service></service>—— 配置变更不会被读取 -
docker-compose restart <service-name></service-name>不会重建镜像，只重启现有容器，适用于纯配置热重载（如某些支持 signal 的进程）
