如何让Git识别WordPress主题目录下的Git子模块？

1. 检查本地子模块配置与状态 #

• 执行git submodule status确认本地子模块状态：若输出以-开头，说明子模块未完成初始化。
• 校验.gitmodules文件内容，确保路径与仓库URL匹配，示例格式如下：

  [submodule "wp-content/themes/salient-child"]
      path = wp-content/themes/salient-child
      url = git@gitlab.com:xxxx-sites/xxxx.git
  

• 查看.git/config文件，确认是否同步了上述子模块配置，若缺失则手动添加。

2. 重新初始化并拉取子模块 #

执行以下命令完成本地子模块的初始化与代码拉取：

git submodule init
git submodule update --recursive

--recursive参数用于确保子模块内部的嵌套仓库（如有）也能被同步。

3. 修复服务器端空目录问题 #

• 若服务器是首次克隆仓库，直接使用递归克隆命令：

  git clone --recurse-submodules git@gitlab.com:xxxx-sites/[站点根仓库地址].git
  

• 若服务器已克隆过仓库，先拉取远程更新，再初始化子模块：

  git pull origin [你的分支名]
  git submodule init
  git submodule update
  

4. 修复GitLab显示异常 #

• 确认主题仓库URL有效，且当前用户拥有该仓库的SSH访问权限（服务器与本地均需配置正确的SSH密钥）。
• 重新提交子模块引用到远程根仓库：

  git add .gitmodules wp-content/themes/salient-child
  git commit -m "Fix salient-child theme submodule configuration"
  git push origin [你的分支名]
  

  注意：wp-content/themes/salient-child在Git中是指向子模块特定提交的特殊引用，需单独添加后提交。

5. 清理主题目录的旧Git痕迹 #

若主题目录曾是独立仓库，残留的.git文件夹会干扰子模块工作，需手动清理：

rm -rf wp-content/themes/salient-child/.git
git add wp-content/themes/salient-child
git commit -m "Remove old git repository from salient-child theme"
git push

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