diff --git a/docs/zh/reference/default-theme-last-updated.md b/docs/zh/reference/default-theme-last-updated.md index 6c04a2c6..b2db74cc 100644 --- a/docs/zh/reference/default-theme-last-updated.md +++ b/docs/zh/reference/default-theme-last-updated.md @@ -3,7 +3,26 @@ 最近一条内容的更新时间会显示在页面右下角。要启用它,请将 `lastUpdated` 选项添加到配置中。 ::: tip -你必须提交 markdown 文件才能看到最后更新时间。 +VitePress 通过每个文件最近一次 Git 提交的时间戳显示"最后更新"时间,因此你必须提交 markdown 文件才能看到最后更新时间。 + +具体实现上,VitePress 会对每个文件执行`git log -1 --pretty="%ai"`命令以获取时间戳。若所有页面显示相同的更新时间,可能是由于浅克隆(常见于 CI 环境)导致 Git 历史记录受限所致。 + +在 **GitHub Actions** 中修复此问题,请在工作流中添加以下配置: + +```yaml{4} +- name: Checkout + uses: actions/checkout@v4 + with: + fetch-depth: 0 +``` + +其他 CI/CD 平台也有类似设置。 + +若上述选项不可用,可在 `package.json` 中的 `docs:build` 命令后手动添加获取操作: + +```json +"docs:build": "git fetch --unshallow && vitepress build docs" +``` ::: ## 全局配置 {#site-level-config}