解决Error:fatal:No Url Found for Submodule Path 'Public' in .Gitmodules.使用github Page部署失败。

2024-12-04 约 300 字预计阅读 2 分钟 - 次阅读 - 条评论

https://gorantan-blog.oss-cn-shanghai.aliyuncs.com/pic/20241204102529533.jpg

解决Error: fatal: No url found for submodule path ‘public’ in .gitmodules：使用github page部署失败。

使用Github page部署博客，push之后在仓库发生报错，GitHub部署失败，查看details：Error: fatal: No url found for submodule path 'public' in .gitmodules，发现是.gitmodules的错误。

查看本地的.gitmodules只有三行代码，且path和url都没有问题。并且本地没有任何跟public有关的.gitmodules，找遍了其他配置文件都没看到。在网上的解决方法是更新submudule，无效，报错。

1
2


git submodule init
git submodule update

查看状态，依旧报错

1

git submodule status

最后参考：同步子模块时出现gitmodules里不存在的path - 某人的小栈得已解决

是缓存的问题，原因：之前手动把.gitmodules的文件删了一部分，但是缓存没有更新。

解决方法：清楚缓存，有几个删几个。

1
2


$ # 把缓存里的public目录清理掉
git rm --cached public

即使如此，还是报错，这里怀疑是git的本地仓库一直有文件储藏了submodule的信息。尝试直接删除，强制推送。

在执行 git add. 操作时，发现自己忽略的warning可能是报错的原因：Git 检测到你正在将项目内的 themes/hugo-theme-reimu 和 themes/hugo-theme-stack 这两个本身是 git 仓库（也就是嵌入式 git 仓库）的目录添加进来。这意味着它们可能不是以正确的子模块形式存在于当前仓库中，而只是单纯作为嵌套的 git 仓库被添加，这样会导致一些潜在问题，比如克隆外层仓库时不会包含这些嵌入式仓库的内容，并且也不知道如何获取它们。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


Administrator@DESKTOP-CADL72R MINGW64 /g/code/github/hugo-FixIt/my-blog (main)
$ git add .
warning: adding embedded git repository: themes/hugo-theme-reimu
hint: You've added another git repository inside your current repository.
hint: Clones of the outer repository will not contain the contents of
hint: the embedded repository and will not know how to obtain it.
hint: If you meant to add a submodule, use:
hint:
hint:   git submodule add <url> themes/hugo-theme-reimu
hint:
hint: If you added this path by mistake, you can remove it from the
hint: index with:
hint:
hint:   git rm --cached themes/hugo-theme-reimu
hint:
hint: See "git help submodule" for more information.
warning: adding embedded git repository: themes/hugo-theme-stack

而在github action的部署文件中也有一行：

1

submodules: recursive # Fetch Hugo themes (true OR recursive)

在这里recursive表示递归地获取子模块。如果项目使用了 Hugo 主题（Hugo themes）并且这些主题是以子模块的形式包含在项目中的，这个设置就会将主题相关的子模块以及这些子模块可能依赖的其他更深层次的子模块（如果有的话）全部获取下来。

**错误的原因：**我git拉取了好几个hugo的theme，但是只使用了一个，在action配置文件中有一个参数recursive表示递归地获取子模块，所以导致每次都会有文件外的submodule找不到url和path。

**解决方法：**删除这两个主题，并且清除子模块配置残留（本地）删除本地子模块目录（如果存在）：使用rm -rf命令删除本地仓库中对应的子模块目录。例如：

1
2
3


rm -rf public
rm -rf themes/hugo - theme - reimu
rm -rf themes/hugo - theme - stack

清除Git缓存中的子模块信息：执行以下命令来清除Git缓存中的子模块信息，这有助于确保Git不会再尝试使用已删除子模块的旧配置。

1
2
3


git config - - remove - section submodule.public
git config - - remove - section submodule.themes/hugo - theme - reimu
git config - - remove - section submodule.themes/hugo - theme - stack

使用git push - - force将修改后的历史记录推送到远程仓库。

成功解决

如果觉得有用，可以赞赏我一杯咖啡，感谢支持！

赞赏

微信