Hugo主题子模块标记为脏无法更新，如何恢复控制权并修改样式？

我之前用Hugo子模块主题的时候也碰到过一模一样的问题——直接改子模块里的文件导致Git标记脏状态，推送不了。给你两种解决方案，按需选择：

方案一：重新获得子模块控制权并保留你的修改 #

如果就是想直接修改子模块文件，那得把你的修改提交到子模块仓库，再更新主仓库的引用：

• 先进入子模块目录：cd themes/whiteplain
• 查看你的修改内容确认一下：git status
• 提交子模块里的修改：git add .，然后git commit -m "自定义背景色"
• 回到主仓库根目录：cd ../..
• 更新主仓库对子模块的引用：git add themes/whiteplain，接着git commit -m "更新whiteplain子模块到自定义版本"
• 现在再用GitHub Desktop推送就不会有脏状态提示了。

⚠️ 注意：这么做之后，后续如果原Whiteplain主题仓库有更新，你拉取的时候可能会遇到冲突，需要手动合并代码。如果只是临时改一下，也可以用重置子模块的方式放弃修改：git submodule update --init --recursive，这个命令会把子模块恢复到主仓库指定的原始版本，你的修改会被覆盖。

方案二：不依赖子模块修改颜色（更推荐的最佳实践） #

Hugo原生支持主题文件覆盖，完全不用碰子模块，就可以自定义样式，这也是官方推荐的方式：

方法1：覆盖主题CSS文件 #

• 在你的主仓库根目录创建assets/css目录（如果没有的话）
• 找到Whiteplain主题里控制背景色的CSS文件，一般是themes/whiteplain/assets/css/style.css
• 把这个文件复制到主仓库的assets/css/style.css路径下
• 修改复制后的文件里的背景色属性（比如找到body选择器的background-color，改成你想要的颜色）
• Hugo会自动优先加载主仓库里的这个CSS文件，完全不会影响子模块，也就不会出现脏状态问题。

方法2：添加自定义样式片段 #

如果不想复制整个CSS文件，也可以只加自定义样式：

• 在主仓库的layouts/partials目录下创建custom_head.html文件
• 在文件里添加自定义样式：

<style>
  body {
    background-color: #f0f0f0; /* 替换成你想要的颜色值 */
  }
</style>

• Hugo会自动把这个片段加载到页面的<head>里，覆盖主题的默认样式，同样不会修改子模块。

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