Docker Compose Watch 怎么同步代码并自动重建

Docker Compose Watch 的常用配置是：源代码目录使用 action: sync，把修改同步到正在运行的容器；依赖清单或构建关键文件使用 action: rebuild，让 Compose 重新构建镜像并替换服务容器。两类规则都写在服务的 develop.watch 下。

官方地址：https://docs.docker.com/compose/how-tos/file-watch/

步骤一：先确认服务满足 Watch 前提

打开“项目根目录 → compose.yaml → services.web”，先确认服务使用 build，而不是只有预构建的 image。容器镜像还应包含 stat、mkdir、rmdir，并允许容器用户写入稍后配置的 target。

# 查看 Compose 版本，Watch 至少需要 2.22.0。
docker compose version

# 展开并检查 Compose 配置，先排除 YAML 层级错误。
docker compose config

步骤二：给源码配置 sync，给依赖配置 rebuild

在“compose.yaml → services.web → develop → watch”添加两条规则。源码保存后直接同步到 /app/src；package.json 改动则重建镜像。node_modules/ 不参与同步，避免宿主机与容器平台的原生依赖互相覆盖。

services:
  web:
    build: .
    command: npm run dev -- --host 0.0.0.0
    develop:
      watch:
        # 源码改动只同步，交给开发服务器热重载。
        - action: sync
          path: ./src
          target: /app/src
          initial_sync: true
          ignore:
            - node_modules/

        # 依赖声明改变后重建镜像并替换容器。
        - action: rebuild
          path: package.json

保存文件后再次执行 docker compose config。可见的成功标准是配置能够正常展开，且 develop.watch 下保留两条规则，而不是被错误缩进到 build 或 command 内。

步骤三：启动 Watch 并观察监控状态

在项目根目录的命令面板中运行：

# 构建并启动服务，同时进入文件监控模式。
docker compose up --watch

如果不想把应用日志与同步、重建事件混在一起，也可以先启动服务，再单独执行 docker compose watch。进入监控状态后，保持这个进程运行。

步骤四：分别验证同步与自动重建

先修改并保存 src/ 下的源文件。事件区域应出现同步到容器 target 的提示，服务不需要替换容器；支持热重载的框架会继续刷新应用。随后修改 package.json，事件区域应显示重新构建镜像并重新创建 web 服务。

常见问题

保存代码后提示没有写入权限怎么办？

检查容器的 USER 是否能写入 target。Dockerfile 复制源码时可使用 COPY --chown，让文件所有者与运行用户一致。

为什么修改文件没有触发 Watch？

先确认路径相对项目目录、文件没有被 .dockerignore 或当前规则的 ignore 排除，并注意 Watch 路径不支持 glob 表达式。需要筛选扩展名时应按当前 Compose 版本查看 include 支持。