如何对博客进行版本更新并推送

在日常维护 Hugo 博客的过程中,我们不仅会不断写新文章,还会对主题、样式和功能进行改进。为了更好地管理这些变化,给博客打上 版本号 是一个好习惯。这样可以清晰地记录每个阶段的更新内容,也方便回溯。


为什么要进行版本管理?

  • 清晰记录:知道每个版本新增了哪些功能或修复了哪些问题
  • 方便回滚:如果新版本出现问题,可以快速回退到旧版本
  • 发布节奏:通过版本号来标记“里程碑”更新,而不是每次小改动都算一个版本

版本号规范(SemVer)

我们采用语义化版本号(Semantic Versioning),格式为:

主版本号.次版本号.修订号

  • 主版本号 (MAJOR):有不兼容的重大变更时 +1
  • 次版本号 (MINOR):新增功能且向下兼容时 +1
  • 修订号 (PATCH):修复 bug 或小改动时 +1

例如:

  • 1.0.0 → 初始版本
  • 1.1.0 → 新增移动端支持
  • 1.1.1 → 修复移动端样式 bug

操作步骤

1.提交代码

git add .
git commit -m "feat: 增加移动端支持"

2. 打标签(Tag)

git tag -a v1.1.0 -m "Release v1.1.0: 增加移动端支持"

3. 推送到 GitHub

git push origin main
git push origin v1.1.0

4. 发布 Release(可选)

在 GitHub 仓库 → ReleasesDraft a new release
选择 v1.1.0 标签,填写更新说明并发布。


日常更新 vs 版本更新

  • 日常更新(写文章、改配置): 直接 git push origin main,GitHub Actions 会自动部署到 Pages。
  • 版本更新(新增功能、主题改版): 除了 git push,还要打上版本号标签并发布 Release。

覆盖更新标签(特殊情况)

如果打错了版本号(比如误打成 v1.2.0),可以这样修正:

git tag -d v1.2.0
git push origin --delete v1.2.0
git tag -a v1.1.0 -m "Release v1.1.0: 修正版本"
git push origin v1.1.0

总结

  • 日常写文章:直接 git push
  • 重要更新:打版本号 + 发布 Release
  • 版本号规则主.次.修订,根据更新内容递增

通过这种方式,你的 Hugo 博客就有了清晰的版本演进记录,也方便未来维护和回溯。