本文介绍一种安全、可靠且无需暴露私有仓库 api 凭据的方式，通过构建时（build-time）执行 git 命令提取最新提交时间，并注入到静态网站 html 中，适用于 jekyll、hugo、next.js、vuepress 等各类静态站点生成器。
本文介绍一种安全、可靠且无需暴露私有仓库 api 凭据的方式，通过构建时（build-time）执行 git 命令提取最新提交时间，并注入到静态网站 html 中，适用于 jekyll、hugo、next.js、vuepress 等各类静态站点生成器。
在私有 GitHub 仓库托管的静态网站中，直接通过前端 JavaScript 调用 GitHub REST API 获取 last_updated 时间是不可行的——不仅因仓库私有导致 API 请求返回 404，更因跨域限制与认证密钥泄露风险而被严格禁止。正确解法是将时间戳生成逻辑移至构建阶段：利用本地已检出的 Git 仓库元数据，通过命令行获取最新提交时间，并将其注入模板或预渲染 HTML 中。
✅ 推荐方案：构建时注入 Git 最新提交时间
Git 提供了轻量、精确的命令来获取仓库级最后更新时间：
# 获取整个仓库最新一次 commit 的 ISO 格式时间（推荐） git log -1 --format=%ai | head -n1 # 或输出为人类可读格式（如 "May 9 2023"） git log -1 --format=%cd --date=format:'%b %d, %Y'
该命令不依赖网络、不访问 GitHub API，仅读取本地 .git 目录，完全适配 CI/CD 流程（如 GitHub Actions、GitLab CI、Vercel Build、Netlify Build）。
? 实现示例（以通用 Shell + 模板替换为例）
假设你使用一个简单 HTML 模板，其中包含占位符：
<!-- index.html -->
<footer>
<small>Last updated: {{LAST_UPDATED}}</small>
</footer>在构建脚本（如 build.sh）中执行：
#!/bin/bash
# 获取格式化时间（注意：确保时区一致，推荐用 UTC 或显式指定）
LATEST_DATE=$(git log -1 --format=%cd --date=format:'%b %d, %Y' 2>/dev/null || echo "Unknown")
# 替换占位符（Linux/macOS 均兼容）
sed -i '' "s/{{LAST_UPDATED}}/$LATEST_DATE/g" index.html
# ⚠️ 注意：macOS 的 sed 需空字符串参数 `-i ''`；Linux 用 `-i`✅ 优势：零外部依赖、零认证风险、构建结果确定且可缓存；❌ 不适用纯前端部署（如直接 git push 到 GitHub Pages 的 gh-pages 分支且无构建步骤）。
? 主流框架集成建议
- Jekyll：使用 jekyll-last-modified-at 插件（仅支持文件级），或自定义 site.time_last_updated 变量（通过 _plugins/last_updated.rb 调用 git log）。
- Hugo：在 hugo.toml 中配置 build.preprocess 脚本，或使用 --buildDrafts 配合 git log 输出写入 .Site.Data.last_updated。
- Next.js / VuePress / Astro：在 getStaticProps / setup() / generateStaticParams 中调用 execSync('git log -1 ...')（需确保构建环境含 Git）；生产环境务必关闭 dev 模式下的动态执行。
⚠️ 关键注意事项
- 时区一致性：%cd 默认使用作者时区，建议统一用 %ai（ISO 8601 UTC）并前端格式化，或在 CI 中设置 TZ=UTC。
-
CI 环境 Git 深度：GitHub Actions 默认 shallow clone（--depth=1），需显式取消：
- uses: actions/checkout@v4 with: fetch-depth: 0 # 获取完整历史，否则 git log 失效 - 安全性：切勿在客户端 JS 中拼接 GitHub Token；所有 Git 操作必须在服务端或构建环境中完成。
- 语义准确性：“Last Updated” 应指内容变更而非部署时间——git log -1 正确反映源码最后一次修改，优于 Date.now() 或 CI BUILD_TIME。
✅ 总结
为私有 GitHub 仓库驱动的网站添加“最后更新时间”，唯一健壮、安全、可复现的路径是：在构建流程中调用 git log -1 提取时间戳，并通过模板引擎或文本替换注入最终 HTML。该方法规避了 API 权限、跨域、速率限制等全部前端陷阱，同时保持轻量、透明与可审计性。无论你使用何种静态站点生成器，只要构建环境能运行 Git 命令，即可分钟内落地实施。
