惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

aimingoo的专栏
aimingoo的专栏
宝玉的分享
宝玉的分享
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
WordPress大学
WordPress大学
V
V2EX
Apple Machine Learning Research
Apple Machine Learning Research
J
Java Code Geeks
腾讯CDC
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
Engineering at Meta
Engineering at Meta
L
LangChain Blog
Jina AI
Jina AI
博客园 - 叶小钗
B
Blog RSS Feed
Recent Announcements
Recent Announcements
H
Help Net Security
小众软件
小众软件
大猫的无限游戏
大猫的无限游戏
B
Blog
云风的 BLOG
云风的 BLOG
Blog — PlanetScale
Blog — PlanetScale
D
DataBreaches.Net
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
罗磊的独立博客

Dlog

数字时代的沉默守护者:致敬 KeePass 之父 Dominik Reichl 🔐 Web Key Directory (WKD) 部署指南 刀锋上的晨间哲学:316L 不锈钢与我的理容仪式 📘 Git 极简生存指南 📘 TortoiseGit 子模块核验手册:如何看懂 PaperMod 改了什么? 平安夜,给这个 17 岁的数字家园挂上一串代码风铃 🎄 数字世界的火漆印章:我为什么要给博客文章加上 GPG 签名 异星工场蓝图代码 重构实录:Hugo+PaperMod 的终极现代化改造 上帝视角:为 PaperMod 接入 Microsoft Clarity 用户行为分析 Markdown 写作指南:像写代码一样写文章 🛶 “寻路者”的回归:海洋与波利尼西亚文化的重生 PaperMod 主题微调:Profile Mode 下的中文排版精修 告别腾讯 404,重构幽灵页面 南太平洋的极客简史:从石币区块链到草编飞机 数字领土的隐秘江湖:那些关于域名的疯狂往事 R2速率限制规则配置 蝴蝶效应:一张 25MB 的图片,让我买下了 .org 大良印记买锅记 海棠血泪 修复访客地图 PaperMod 中的 Google Analytic 配置 fnOS极简版「智能屏幕管理」方案 fnOS「开机10分钟后自动关闭屏幕」配置方案 Markdown中常用的HTML代码 再看海贼王 修复Microsoft Store应用更新 新旧交替之际 剃须装备 湿式剃须
📘 TortoiseGit 子模块更新(升级)操作手册
Chow Ray · 2025-12-25 · via Dlog

适用场景:当 Hugo PaperMod 主题发布了新版本,你需要将本地的 themes/PaperMod 文件夹升级到官方最新版时。

1. 核心操作:勾选策略

在博客根目录,右键 -> TortoiseGit -> 子模块更新 (Submodule Update)

请严格按照下图勾选(四项全选):

选项 (中文)选项 (英文)状态核心理由 (Why)
初始化子模块--init勾选防漏。万一主题作者新增了内部依赖,这能保证配置被正确初始化,有备无患。
递归--recursive勾选防套娃。如果 PaperMod 内部还引用了别的子模块,这个选项能一并更新,防止报错。
远端跟踪分支--remote勾选⭐ 升级核心。只有勾选它,Git 才会去下载“最新版”。如果不勾,Git 只会将主题重置回你上次记录的旧版本(原地踏步)。
变基--rebase勾选防冲突/保整洁。如果你不小心改动了主题里的文件,或者文件权限变了,“变基”能把你的改动“浮”在最新版之上,保持历史线是一条直线,比“合并(Merge)”更干净。

2. 关键后续:提交变更 (Commit)

点击“确定”并显示成功后,工作只完成了一半!

此时,你的博客主程序发现:“咦?themes/PaperMod 这个文件夹的内容变了(指向了新的 Commit ID)。”

必须执行以下操作,否则 Cloudflare 构建时依然是用旧版主题:

  1. 回到根目录:你会发现 themes 文件夹上有红色叹号❗。
  2. 提交 (Git Commit)
    • 右键根目录 -> Git 提交 (Commit)
    • 你会看到变更列表中只有一行:themes/PaperMod
    • 填写日志:Update PaperMod theme to latest version
    • 点击提交。
  3. 推送 (Git Push)
    • 运行你的 deploy.sh 或者手动推送。

3. 技术辨析:为什么比 DeepSeek 多两项?

DeepSeek 建议只选 递归 + 远端,这在 90% 的情况下是能跑通的。但我建议多选两项的理由是:

  1. 为什么要加 Init
    • 有些复杂主题可能会引入新的 Icon 库或字体库作为子模块。如果不选 Init,更新后可能因为缺文件报错。多选它没有任何副作用,只有安全感。
  2. 为什么要选 Rebase
    • 默认情况下,Submodule Update 可能会尝试 Checkout(检出)。
    • 如果你在 Windows 下不小心修改了主题文件的换行符(CRLF问题),直接 Checkout 可能会失败或报错。
    • 使用 Rebase 是最强力的**“自动纠错”**手段,它能强行把更新应用上去。

📝 极简口诀

“要升级,找小乌龟(TortoiseGit)。
初始化、递归、远端、变基,四个钩钩全打上。
更完别忘 Commit,否则白忙一场。”

把这篇存好,下次 PaperMod 更新时,照做即可! 🛡️🚀