WordPress第三方插件Addon的Git子模块使用及兼容问题咨询

核心结论 #

既不推荐用 git submodule，也不建议直接 git add 嵌套仓库目录，最优方案是通过 .gitignore 忽略该目录，配合手动版本记录解决需求。

为什么不能直接 git add #

直接执行 git add my-plugin 会触发Git警告，因为该目录包含独立的 .git 仓库。Git会将其识别为gitlink（一种特殊的指针文件），而非跟踪实际文件内容：

• 你无法访问该嵌套仓库的远程地址，无法同步或推送对应的仓库内容；
• 插件自动更新时会切换分支、执行 git pull，导致gitlink指向的提交哈希变更，主仓库会持续出现未提交的变更，完全无法正常管理。

为什么不能用 git submodule #

git submodule 的核心是绑定外部仓库的特定提交，需要你拥有该仓库的访问权限并手动管理版本，但你的场景完全不满足：

• 无权限访问Addon的Git远程仓库，无法初始化submodule；
• 插件会自动修改自身的分支和提交，导致submodule的状态永远处于“脏”状态，主仓库无法正常提交或同步，彻底打乱submodule的管理逻辑。

最优解决方案 #

1. 忽略嵌套仓库目录
   编辑主仓库的 .gitignore 文件，添加Addon目录路径，让Git不再跟踪该目录：

   wp-content/plugins/my-plugin/
   

   执行 git status 就不会再显示该目录为未跟踪状态，也不会触发警告。

2. 可选：手动维护版本记录
   如果需要在主仓库中留存Addon的版本信息，可以创建一个独立文件（比如 plugin-versions.txt），手动记录Addon的版本号，将该文件提交到主仓库：

   # plugin-versions.txt
   my-plugin: 1.0.3
   

   插件更新后，同步修改该文件并提交，即可在主仓库中追溯版本变更。

3. 特殊场景：必须跟踪Addon文件内容
   若一定要将Addon文件纳入主仓库跟踪，只能删除其内部的 .git 目录：

   rm -rf my-plugin/.git
   

   之后即可正常 git add my-plugin 并提交，但此操作会导致插件的自动更新功能失效（因为它依赖自身Git仓库执行 git pull），需要手动更新Addon，属于取舍后的选择。

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