寻求基于Docker的Git环境优化方案：子模块分支困境解决建议

1. 用环境变量替换配置（优先推荐） #

把应用配置里的硬编码localhost改成读取环境变量，比如将localhost:8080替换为${SERVICE_HOST}:${SERVICE_PORT}，同时给变量设置默认值为localhost。这样本地开发时自动用默认值，Docker环境则通过docker-compose.yml注入对应容器名：

services:
  submodule1:
    environment:
      - SERVICE_HOST=submodule2
      - SERVICE_PORT=5432
  submodule2:
    ports:
      - "5432:5432"

全程不用修改应用仓库的任何文件，也不需要维护专用分支，本地和Docker环境的配置逻辑完全隔离。

2. 容器启动时动态修改配置 #

通过Docker启动命令或脚本，在容器启动前动态替换配置文件里的localhost为目标容器名。比如用sed直接修改：

services:
  submodule1:
    command: sh -c "sed -i 's/localhost/submodule2/g' /app/config.yaml && ./start-app"

也可以把替换逻辑写成独立脚本，放在docker-compose仓库里，挂载到容器中执行：

services:
  submodule1:
    volumes:
      - ./scripts/replace-config.sh:/tmp/replace-config.sh
    command: sh /tmp/replace-config.sh && ./start-app

所有修改都在Docker运行时完成，不会改动应用仓库的代码，彻底避免分支维护问题。

3. 用Git钩子拦截误提交 #

如果必须在子模块本地修改配置，给每个子模块添加pre-commit钩子，阻止配置文件提交到原仓库。在子模块的.git/hooks/pre-commit中添加：

#!/bin/sh
# 检测目标配置文件是否被修改
if git diff --name-only HEAD | grep -q "config.yaml"; then
    echo "错误：禁止提交配置文件修改，请用本地覆盖或环境变量方式"
    exit 1
fi

再写个初始化脚本，在拉取子模块后自动把钩子复制到每个子模块的钩子目录：

#!/bin/bash
for submodule in applications/*; do
    cp ./hooks/pre-commit "$submodule/.git/hooks/"
    chmod +x "$submodule/.git/hooks/pre-commit"
done

开发者误提交时钩子会直接拦截，避免污染原仓库。

4. 本地配置文件覆盖 #

让应用支持加载.gitignore里的本地配置文件（比如config.local.yaml），默认配置保持不变。Docker环境中，从docker-compose仓库挂载定制好的配置文件到容器：

services:
  submodule1:
    volumes:
      - ./configs/submodule1-docker-config.yaml:/app/config.local.yaml

本地开发时开发者可自行添加config.local.yaml覆盖默认值，Docker环境用仓库里的定制配置，原仓库代码完全不需要改动。

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