子模块更新失败是本地状态、配置与远程三者错位的综合结果，非单纯网络问题；“not a git repository”表明目标目录缺失.git文件，需先验证主仓库完整性，再通过deinit、清理、重init修复，URL或分支变更须同步配置并手动校验。
子模块更新失败不是网络问题单选题，而是本地状态、配置、远程三者错位的综合结果。直接重试 git submodule update --init --recursive 大概率无效。
子模块报错“not a git repository”或“fatal: not a git repository”
这说明 Git 根本没把目标目录当仓库看，常见于 ZIP 下载项目、误删 .git 或初始化中断后残留空文件夹。
- 先确认当前目录是合法 Git 仓库：
git rev-parse --git-dir—— 若报错或返回空，说明主项目本身就不完整 - 检查子模块路径下是否存在
.git文件（注意是文件，不是目录）：ls -a your_submodule_path/.git—— 若不存在，就是“假克隆” - 强制清理并重建：
git submodule deinit -f your_submodule_path，再rm -rf your_submodule_path，最后git submodule update --init your_submodule_path
执行 git submodule update --remote 报 “Unable to find current origin/master revision”
本质是子模块里找不到它该 checkout 的那个分支引用，不一定是网络问题，更可能是分支名变更或远程历史被改写。
GitHub一键发布助手（专业版）
下载
本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、"
- 进子模块目录手动检查：
cd your_submodule_path && git branch -r—— 看是否有origin/master；若只有origin/main，说明默认分支已切为main - 临时切到对应分支：
git checkout main，再回到主项目执行git add your_submodule_path && git commit -m "update submodule to main" - 长期解法：在
.gitmodules中显式指定分支，加上branch = main行，然后运行git submodule sync
子模块 URL 变更后同步失败（如 GitHub → Gitee 镜像）
Git 不会自动感知 .gitmodules 里改过的 URL，旧配置仍缓存在 .git/config 和子模块内部的 .git/config 中。
- 先同步配置变更：
git submodule sync --recursive—— 这步必须做，否则update仍用旧 URL - 再清理子模块本地记录：
git submodule foreach --recursive 'git config --unset-all remote.origin.url' - 最后拉取：
git submodule update --init --recursive；如果还失败，加--force强制覆盖本地状态
最容易被忽略的是：子模块的 commit hash 被主项目锁定，但那个 commit 在远程仓库里已被 force push 删除。这时任何 update 都会卡在“找不到该 revision”。遇到这种场景，得先联系子模块维护者确认是否保留了历史，或改用 tag/branch 模式替代 commit 锁定。
