本文章没有找到对应的语言版本

发现新版本

网站好像有新内容，是否更新(ﾟ⊿ﾟ)ﾂ？

TL;DR 太长不看： 一键跳转到解决方案

问题回顾

今天在从Hugo Module切换到Git子模块管理主题时，遇到了一个问题
在GitHub Action中构建时，报错：

1
2
3
4

Run hugo --minify
Total in 2 ms
Error: failed to load modules: module "reimu" not found in "/home/runner/work/Blog/Blog/themes/reimu"; either add it as a Hugo Module or store it in "/home/runner/work/Blog/Blog/themes".: module does not exist
Error: Process completed with exit code 1.

检查了构建action，确实存在拉取子模块的内容：

1
2
3
4
5

  - name: Checkout private repository
    uses: actions/checkout@v4
    with:
        submodules: true # Fetch submodules
        fetch-depth: 0    # Fetch all history for .GitInfo and Lastmod

相关搜索

经过一番搜索，找到两个相关帖子：

  1. Git submodule failure when building pages with Hugo - 使用 Hugo 构建页面时 Git 子模块失败
  2. Hugo submodule with PaperMod - error says to remove site from .gitmodules but it’s not there - 使用 Hugo 和 PaperMod 的子模块 - 错误提示从.gitmodules 中删除站点，但那里没有

两者都提到了关于清空git submodule，重新添加子模块的问题

解决方案

首先检查工作流文件是否存在拉取子模块内容，排除工作流问题

1
2
3
4
5

  - name: Checkout repository
    uses: actions/checkout@v4
    with:
        submodules: true # Fetch submodules
        fetch-depth: 0    # Fetch all history for .GitInfo and Lastmod

确认工作流没问题，就多半是子模块没添加成功

删除子模块使用指令

1
2

# reimu请替换成你的主题名称
git rm --cached themes/reimu

然后重新执行

1
2

# 对应内容请修改为你用的主题
git submodule add https://github.com/D-Sketon/hugo-theme-reimu.git themes/reimu

这个时候注意！

此时，你的Git提交区域会出现这样的暂存提交(忽略删除线，这是我又删掉模拟的)
VScode暂存更改截图

这个是子模块的git目录，一旦你从暂存里去掉这个提交，他就不太好再被提交上去了
当你没有这个目录的时候，哪怕提交了.gitsubmodule，git也不会认为存在子模块

至此，问题解决~

(〃∀〃)

giscus