Hugo自动修正文章最后修改时间的最佳方案

Sun, 25 Jan 2026 00:00:00 +0000

Hugo 全自动修正文章修改时间的最佳实践（Serverless 场景）

在使用 Hugo 构建静态博客时，文章的修改时间（Last Modified Time） 是一个非常重要但又容易踩坑的问题，尤其是在 Serverless / CI 自动部署 场景下。

Hugo 官方目前提供了多种用于确定文章修改时间的方式：

Hugo 支持的修改时间来源

:filemodtime
使用文件本身的最后修改时间作为文章的修改时间。
lastmod
需要在文章 Front Matter 中手动维护 lastmod 字段。
:git
使用 Git 中该文件的最后一次提交时间作为修改时间（依赖 gitinfo）。
date
使用文章的发布时间作为修改时间。

各方案的自动化可行性分析

在上述方案中：

✅ 可自动化
- :filemodtime
- :git
❌ 不适合全自动
- lastmod（需要人工维护）
- date（语义不符）

:filemodtime 在 Serverless 场景下的问题

使用 Hugo 的一个重要原因，正是为了 方便地将网站部署到 Serverless 平台（如 Cloudflare Pages、Vercel、Netlify 等）。

然而在 Serverless / CI 场景中：

每次部署都会重新 git clone 仓库
所有文件的 文件系统修改时间 都会变成「拉取时间」
这会导致：
- 所有文章的修改时间被错误地更新为“本次部署时间”
- 完全失去文章真实修改时间的意义

因此，:filemodtime 在默认情况下并不适合 Serverless 场景。

:git 方案的现实问题

理论上，:git 是最理想的方案：

修改时间与 Git 提交严格一致
完全自动化
不依赖文件系统时间戳

但在实际使用中：

即使开启了 enableGitInfo = true
某些情况下 :git 无法正确生效
在 CI / Serverless 环境中尤为明显

不确定这是环境限制、Git shallow clone、还是 Hugo 本身的 Bug，但结果是：该方案在实践中不够稳定。

最终解决方案：修改文件时间戳为Git 提交时间 + :filemodtime

综合以上问题，我最终总结出了一套最适合 Serverless 管理的全自动方案：

核心思路

在 Hugo 构建之前，将文件的修改时间戳“伪装”为 Git 最后提交时间。

具体流程如下：

Hugo 中使用 :filemodtime 作为文章修改时间来源

1
2

[frontmatter]
lastmod = [':fileModTime']

将脚本放在文件夹根目录
将自动执行脚本的命令和正式部署命令合二为一(这里需要注意的是一般的serverless平台拉取项目只是浅层克隆不会把文件的最后提交信息给拉取过来，所以我们要在最前面要执行完整的拉取命令。)

`1`	`git fetch --unshallow && chmod +x 1.sh && ./1.sh && hugo`

这样就可以做到：

✅ 修改时间与 Git 提交时间一致
✅ 完全自动化
✅ 与 Serverless / CI 环境完美兼容

自动同步 Git 提交时间到文件修改时间的脚本

下面的脚本用于：

将当前目录下所有文件的最后修改时间，统一修改为对应的 Git 最后提交时间

# （此处放置你的脚本内容）
#!/bin/bash
# git-set-filetime.sh
# 功能：将 git 仓库中所有被追踪文件的修改时间改为最后一次提交时间

# 确保当前目录是 git 仓库
if [ ! -d ".git" ]; then
    echo "Error: 当前目录不是 git 仓库根目录"
    exit 1
fi

# 获取所有被追踪文件（包含特殊字符/空格/中文）
git ls-files -z | while IFS= read -r -d '' file; do
    # 获取最后一次提交的 Unix 时间戳
    timestamp=$(git log -1 --format="%ct" -- "$file")
    
    if [ -n "$timestamp" ]; then
        # 使用 touch 修改文件修改时间
        # -d "@$timestamp" 表示从 Unix 时间戳设置时间
        touch -d "@$timestamp" "$file"
        echo "Updated: $file -> $(date -d "@$timestamp" '+%Y-%m-%d %H:%M:%S')"
    else
        echo "Skipped (not tracked): $file"
    fi
done

echo "All tracked files' modification times updated."

博客框架的选择

Tue, 02 Dec 2025 00:00:00 +0000

博客框架我们应该如何选择？

博客大体上可以分为静态博客和动态博客。

动态博客采用的是前端+后端的模式,而静态博客就是纯前端静态文件（方便托管）

动态博客的优缺点:

优点:

适合大型博客或者论坛
自带后台管理评论
功能集成很多，适合小白，基本不需要额外去弄什么

缺点:

资源占用大
必须依赖服务器运行，不可使用静态host主机/serverless服务提供商(cloudflare/vercle/github pages)
网站加载速度相对较慢
有一定的运维成本(服务器/防火墙等费用)

静态博客的优缺点:

优点:

加载速度相对较快
资源占用少。
可以将网站交给serverless服务商托管（白嫖党狂喜，不需要专门的服务器）

缺点:

要有一定的web技术功底，会手动改配置文件、布局,写文章模板
框架集成的功能较少，如评论功能，音频播放器，需要自行对接第三方接口（不过很多静态博客主题里面已经把功能模板写好了，只需要更换接口地址就行）
缺乏统一的后台管理功能

动态博客框架

WordPress★★★

  世界知名动态博客框架，主题资源插件丰富，教程多。

Typecho

 轻量级动态博客框架，主打一个快速部署，快速上线

Halo★★

 界面很漂亮，资源插件相对来说比较丰富，社区正在逐步发展，安装部署方法较为麻烦，比较吃服务器性能

静态博客框架

Hexo★★★

 node.js开发,教程很多，社区插件主题资源丰富，缺点是当文章数量>1k时，构建速度会显著减缓

Hugo★★★

 go语言开发,使用go template模板，学习门槛相对其他的来说高点。运行build效率很高,支持热加载,更改不需要刷新网页页面即可生效。教程资源丰富,社区插件资源也很多，稍逊hexo,最大的优势是当文章数量很多时，构建静态网站的速度可以快其他框架几倍.

Jekyll★★

 资源插件相对较少,界面简洁直观,但有github官方支持,可以直接将存入仓库的md文件转换成网页

VitePress

 资源插件丰富，可扩性强,常用于构建文档，不用于博客

Astro★★

新一代静态框架,0 javascript的技术理念让网站首页加载起来非常快,采用服务端渲染的技术理念
可局部初始化组件为spa,增强网站运行效率,可搭配其他前端框架组件使用，但主题资源相对较少。

总结

对于零基础的小白，想搭建博客，首先推荐动态博客框架，首选wordpress,有一定技术基础，搭建自己个人的轻量博客推荐静态框架,首选hexo/hugo,想要更快的构建速度和热加载，选择hugo.如果想尝试更先进的技术理念和更快的首页加载速度，可以尝试astro

杂谈

本站采用hugo构建,github仓库储存,cloudflare远程克隆部署,评论功能对接waline。

博客 on LiaoKE