GitLab中已提交文件夹显示橙色无法打开，本地有内容如何修复？

你遇到的橙色带数字的文件夹是Git的**子模块（submodule）**或损坏的gitlink记录——本地文件夹有实际内容，但仓库里只存储了子模块的引用（而非文件本身），导致服务器拉取时文件夹为空，引发运行异常。以下是两种针对性修复方案：

方案1：移除错误子模块并重新提交内容 #

如果该文件夹是误配置的子模块，按以下步骤操作：

• 先在本地仓库根目录查看子模块状态，确认目标文件夹的子模块记录：

  git submodule status
  

• 移除该子模块：

  # 清除子模块本地配置
  git submodule deinit -f -- 你的文件夹名称
  # 从仓库中删除子模块引用
  git rm -f 你的文件夹名称
  # 提交移除操作
  git commit -m "Remove broken submodule: 你的文件夹名称"
  

• 重新添加本地文件夹内容到仓库：

  git add 你的文件夹名称
  git commit -m "Add content for 你的文件夹名称"
  git push
  

方案2：修复损坏的gitlink记录 #

如果git submodule status未查到对应记录，说明是文件夹被错误标记为gitlink：

• 删除本地缓存的gitlink记录：

  git rm --cached 你的文件夹名称
  

• 重新添加文件夹内容并提交：

  git add 你的文件夹名称
  git commit -m "Fix broken gitlink for 你的文件夹名称"
  git push
  

验证修复 #

推送完成后刷新GitLab仓库页面，目标文件夹会恢复为正常黑色状态，可正常打开查看内容；服务器重新拉取代码后，该文件夹将包含完整内容，站点运行异常问题即可解决。

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