如何在GitHub中查看仓库子模块并在PR评审中展示内容？

GitHub上子模块显示为带向右箭头的不可点击条目是正常默认状态——子模块本质是主仓库内的指针文件，仅记录子模块仓库的特定commit哈希，而非实际存储文件夹内容。要在PR评审等场景中查看子模块的具体改动，可按以下方式处理：

• 确认子模块仓库的访问权限
  主仓库引用的子模块必须是GitHub上可访问的仓库：若为私有仓库，需确保PR评审者拥有该子模块仓库的访问权限，否则GitHub无法拉取内容展示。

• 查看子模块的变更细节
  当主仓库提交包含子模块的commit哈希更新时，PR页面会显示子模块的哈希变动。要查看具体文件改动：

  • 点击PR里子模块条目旁的“Compare”链接，直接跳转至子模块仓库对应commit的变更对比页；
  • 或在本地拉取PR分支后，执行git submodule update --init --recursive，再查看子模块内的文件改动。

• 关联子模块的PR（可选）
  若你在子模块仓库中提交了独立PR，可在主仓库的PR描述中引用子模块的PR编号（格式如关联子模块修复：submodule-repo-1#123），GitHub会自动关联两个PR，方便评审者联动查看改动。

• 改用Git子树替代子模块（按需选择）
  若希望子模块内容直接作为主仓库的一部分展示，而非独立指针，可使用git subtree将子模块仓库内容合并到主仓库：

  • 合并子树命令示例：

    git subtree add --prefix=submodule-repo-1 https://github.com/xxx/submodule-repo-1.git main
    

  • 更新子树命令示例：

    git subtree pull --prefix=submodule-repo-1 https://github.com/xxx/submodule-repo-1.git main
    

  这种方式下，GitHub会像显示普通文件夹一样展示内容，PR中可直接查看子模块内的文件改动。

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