如何避免Git生产与开发分支的环境变量冲突？

针对开发/生产分支因环境变量（IP、网段等）导致的合并冲突或覆盖问题，以下是几个最优实践方案：

1. 拆分环境配置文件 + 合并时保留当前分支配置 #

把环境特定的配置拆成独立文件（比如config.dev.yaml和config.prod.yaml），通用业务代码放在主分支，开发/生产分支仅维护各自的配置文件。合并时通过Git的--ours策略确保当前分支的配置不被覆盖：

• 操作步骤：
  • 拆分配置：将通用逻辑和环境变量分离，主分支存放无环境依赖的代码，开发分支维护config.dev.yaml，生产分支维护config.prod.yaml。
  • 合并代码：从开发分支合并到生产分支时，执行：

    git merge dev --ours -- config.prod.yaml
    

    这条命令会合并所有通用代码，但强制保留生产分支的config.prod.yaml文件，避免IP等变量被覆盖。
• 优点：简单直接，无需额外工具，适合配置文件数量少的场景。

2. 模板文件 + 环境变量注入 #

用模板文件统一存放通用配置结构，环境变量单独存储，通过脚本在部署/构建时渲染成实际配置：

• 操作步骤：
  • 编写模板：创建config.tpl，用占位符替代环境变量，比如：

    dhcp_server: {{DHCP_SERVER_IP}}
    target_file: {{TARGET_FILE}}
    subnet: {{SUBNET}}
    

  • 分支专属变量：每个分支添加.env文件（提交到Git），存储对应环境的变量：
    开发分支.env：

    DHCP_SERVER_IP=192.168.1.10
    TARGET_FILE=fileB
    SUBNET=192.168.1.0/24
    

    生产分支.env：

    DHCP_SERVER_IP=172.16.1.10
    TARGET_FILE=fileB
    SUBNET=172.16.1.0/24
    

  • 渲染脚本：写一个简单的shell/Python脚本，读取.env变量并替换模板生成最终配置文件，比如：

    # render_config.sh
    set -a
    source .env
    set +a
    envsubst < config.tpl > config.yaml
    

• 优点：完全隔离环境变量和业务代码，合并时仅需处理模板文件（通用逻辑），不会出现变量冲突，适合自动化部署场景。

3. 自定义Git合并驱动 #

通过Git属性配置，让环境配置文件在合并时自动保留当前分支版本，无需手动干预：

• 操作步骤：
  • 创建.gitattributes文件，指定配置文件的合并策略：

    config.yaml merge=ours
    

  • 配置Git的合并驱动：

    git config merge.ours.driver true
    

    这条配置告诉Git，当合并config.yaml文件时，直接使用当前分支的版本，忽略来自其他分支的修改。
• 优点：无需拆分文件，对现有代码结构改动小，适合不想调整配置文件结构的场景。

注意事项 #

• 避免将环境变量硬编码到业务代码中，尽量集中管理在配置文件或.env里。
• 合并前先拉取目标分支的最新代码，减少不必要的冲突。
• 可以配合Git钩子（比如pre-merge）自动执行配置文件的合并策略或渲染脚本，进一步简化流程。

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