






















适用场景:当 Hugo PaperMod 主题发布了新版本,你需要将本地的
themes/PaperMod文件夹升级到官方最新版时。
在博客根目录,右键 -> TortoiseGit -> 子模块更新 (Submodule Update)。
请严格按照下图勾选(四项全选):
| 选项 (中文) | 选项 (英文) | 状态 | 核心理由 (Why) |
|---|---|---|---|
| 初始化子模块 | --init | ✅ 勾选 | 防漏。万一主题作者新增了内部依赖,这能保证配置被正确初始化,有备无患。 |
| 递归 | --recursive | ✅ 勾选 | 防套娃。如果 PaperMod 内部还引用了别的子模块,这个选项能一并更新,防止报错。 |
| 远端跟踪分支 | --remote | ✅ 勾选 | ⭐ 升级核心。只有勾选它,Git 才会去下载“最新版”。如果不勾,Git 只会将主题重置回你上次记录的旧版本(原地踏步)。 |
| 变基 | --rebase | ✅ 勾选 | 防冲突/保整洁。如果你不小心改动了主题里的文件,或者文件权限变了,“变基”能把你的改动“浮”在最新版之上,保持历史线是一条直线,比“合并(Merge)”更干净。 |
点击“确定”并显示成功后,工作只完成了一半!
此时,你的博客主程序发现:“咦?themes/PaperMod 这个文件夹的内容变了(指向了新的 Commit ID)。”
必须执行以下操作,否则 Cloudflare 构建时依然是用旧版主题:
themes 文件夹上有红色叹号❗。themes/PaperMod。Update PaperMod theme to latest version。deploy.sh 或者手动推送。DeepSeek 建议只选 递归 + 远端,这在 90% 的情况下是能跑通的。但我建议多选两项的理由是:
Init?Rebase?Submodule Update 可能会尝试 Checkout(检出)。Rebase 是最强力的**“自动纠错”**手段,它能强行把更新应用上去。“要升级,找小乌龟(TortoiseGit)。
初始化、递归、远端、变基,四个钩钩全打上。
更完别忘 Commit,否则白忙一场。”
把这篇存好,下次 PaperMod 更新时,照做即可! 🛡️🚀
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。