docker-compose构建后容器.git文件夹丢失致pre-commit运行报错

核心问题出在docker-compose.yml的卷挂载配置：

• 你在app服务中配置了- ./app:/app的绑定挂载，该配置会在容器启动时，将宿主机本地的./app目录直接映射到容器内的/app路径，镜像构建阶段存放在/app下的所有内容（包括你在RUN步骤中执行git init生成的.git文件夹）都会被挂载的宿主机目录内容完全遮蔽，而非被删除。
• 构建阶段执行ls -a能看到.git，是因为该命令执行在镜像分层构建过程中，此时还未启动容器、也未执行卷挂载，所以能看到构建步骤生成的文件；等容器实际启动后，卷挂载生效，宿主机./app目录本身没有.git文件夹，容器内自然找不到该目录，pre-commit检测不到Git仓库就会抛出对应错误。

可根据实际开发场景选择以下任意一种方案：

• 方案1：缩小卷挂载范围，不直接挂载整个/app目录。只挂载开发时需要实时同步的代码子目录（比如/app/app、/app/core等业务代码路径），避免覆盖镜像构建阶段生成的.git目录、Python虚拟环境等不需要和宿主机同步的内容。
• 方案2：将Git仓库初始化步骤从Dockerfile构建阶段移到容器启动阶段执行。修改服务启动命令，在执行业务逻辑前先判断是否存在.git目录，不存在则自动初始化，参考配置：

command: >
  sh -c "if [ ! -d .git ]; then git init . && git config user.email 'dev@local' && git config user.name 'dev'; fi &&
         python manage.py wait_for_db &&
         python manage.py migrate &&
         python manage.py runserver 0.0.0.0:8000"

单独执行pre-commit检查时，也可以在命令前补初始化步骤：

docker-compose run app sh -c "git init . && /py/bin/pre-commit run --all-files"

• 方案3：如果宿主机的项目根目录本身就是Git仓库，直接调整卷挂载源路径，将包含.git文件夹的项目根目录挂载到容器/app路径，把原配置的- ./app:/app修改为- .:/app即可。注意选择该方案时需要同步调整Dockerfile中的COPY路径，避免代码路径错位。

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