跳转到内容

最后更新于

最近一条内容的更新时间会显示在页面右下角。要启用它,请将 lastUpdated 选项添加到配置中。

TIP

VitePress 通过每个文件最近一次 Git 提交的时间戳显示"最后更新"时间,因此你必须提交 markdown 文件才能看到最后更新时间。

具体实现上,VitePress 会对每个文件执行git log -1 --pretty="%ai"命令以获取时间戳。若所有页面显示相同的更新时间,可能是由于浅克隆(常见于 CI 环境)导致 Git 历史记录受限所致。

GitHub Actions 中修复此问题,请在工作流中添加以下配置:

yaml
- 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"

全局配置

js
export default {
  lastUpdated: true
}

frontmatter 配置

可以使用 frontmatter 上的 lastUpdated 选项单独禁用某个页面的最后更新展示:

yaml
---
lastUpdated: false
---

另请参阅默认主题:最后更新时间 了解更多详细信息。主题级别的任何 truthy 值也将启用该功能,除非在站点或页面级别明确禁用。

基于 MIT 许可发布