Git合并Develop至Main分支时如何保留完整目录结构？

仓库分支说明 #

• Main分支：关联服务器，仅包含客户所需的最小化目录结构
• Develop分支：包含全量目录结构，作为日常开发分支，所有变更最终需合并至Main分支

遇到的问题 #

当模块存在多层子目录且仅修改其中部分文件时，将Develop合并到Main后，Git只会同步被修改的文件，导致缺失未修改的必要文件/目录，进而引发网站运行异常。

示例场景 #

合并前分支结构

Main分支初始结构

- httpdocs
  - layout
    + landing

Develop分支结构

- httpdocs
  - layout
    + landing
    + sections
      - photos
        - controller
          --- photos.php
        - viewer
          --- photos.php
      - videos
        - controller
          --- videos.php
        - viewer
          --- videos.php <-- 仅编辑了此文件

合并后当前结果（不符合预期）

- httpdocs
  - layout
    + landing
    + sections
      - videos
        - viewer
          --- videos.php <-- 仅同步了被编辑的文件，缺失controller目录及文件

期望的合并后结构

- httpdocs
  - layout
    + landing
    + sections
      - videos
        - controller
          --- videos.php (未编辑，需保留)
        - viewer
          --- videos.php <-- 已编辑的文件

解决方案 #

能否实现需求？ #

完全可以，核心是让Git在合并过程中识别并同步完整的模块目录，而非仅处理被修改的单个文件。

替代git add httpdocs/layout/sections/videos的方案 #

1. 合并时同步完整目录
   切换到Main分支执行合并后，直接从Develop分支拉取完整的目标模块目录：

   git checkout main
   git merge develop
   # 同步完整的videos模块目录
   git checkout develop -- httpdocs/layout/sections/videos
   git commit -m "合并develop分支，同步完整videos模块"
   

2. 用git restore从Develop恢复完整目录
   在Main分支上，直接从Develop分支恢复指定模块的全部内容：

   git checkout main
   git restore --source=develop -- httpdocs/layout/sections/videos
   git commit -m "从develop同步完整videos模块"
   

3. 检查并修正.gitignore配置
   排查Main分支的.gitignore文件，确认是否存在意外忽略未修改文件/目录的规则，若有则调整：

   # 编辑.gitignore，移除对videos/controller等目录的忽略规则
   git add .gitignore
   git commit -m "更新.gitignore，确保追踪完整模块目录"
   

4. 用git subtree管理独立模块
   如果这类多目录模块较多，可以将sections目录作为子树单独管理，合并时同步整个子树：

   git checkout main
   git subtree pull --prefix=httpdocs/layout/sections develop main
   

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