如何在Docker开发容器中保持Git与本地项目结构同步？

问题原因 #

你的配置存在两个核心问题导致Git路径识别错误：

1. Git仓库路径不匹配：本地Git根目录是app，但容器内将本地.git挂载到/app/.git，且容器工作目录为/app（对应本地client子目录），导致Git在容器内识别的文件路径与本地完全不一致。
2. 容器内文件冲突：Dockerfile中COPY . /app/将本地client目录的所有文件复制到容器/app，这些文件在本地Git中的路径是client/xxx，但容器内显示为xxx，Git会误判为本地文件被删除、容器内新增未跟踪文件。

解决方案 #

1. 修改Docker Compose配置

调整client服务的挂载规则与工作目录，让容器内Git仓库与本地保持一致：

version: '3'
services:
  server:
    build: ./server
    volumes:
      - ~/.ssh:/root/.ssh
      - ./server/src:/app/src
      - api-modules:/app/node_modules
  client:
    build: ./client
    depends_on:
      - server
    volumes:
      - ~/.ssh:/root/.ssh
      # 挂载整个本地app根目录到容器内的/app-root，确保Git仓库路径匹配
      - .:/app-root
      # 将node_modules挂载到独立volume，避免本地与容器依赖冲突
      - web-modules:/app-root/client/node_modules
    # 设置容器工作目录为本地client目录在容器内的对应路径
    working_dir: /app-root/client
volumes:
  api-modules:
  web-modules:

2. 调整客户端Dockerfile

删除COPY . /app/指令（避免与挂载的本地目录冲突），仅保留依赖安装的必要步骤：

FROM node:10

# 仅复制package文件用于预安装依赖
COPY package.json yarn.lock /app-root/client/

WORKDIR /app-root/client

RUN yarn install

ENTRYPOINT yarn start;

3. 重建并重启容器

在本地app目录下执行命令：

docker-compose down
docker-compose build --no-cache
docker-compose up -d

4. 验证Git状态

重新通过VSCode Remote Container连接客户端容器后，执行：

git status

此时Git应能正确识别本地项目结构，不再显示大量误判的文件修改或删除。

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