GitHub Action Workflow 分析

Dale2026/3/4大约 3 分钟

运行状态

on:
  push:
    branches:
      - main
    paths:
      - 'src/**'
      - 'package.json'
      - 'package-lock.json'

permissions:
  contents: write

runs-on: ubuntu-latest

Checkout：
- 使用 actions/checkout@v4
- 设置 fetch-depth: 0，确保获取完整的 git 历史
设置 Node.js：
- 使用 actions/setup-node@v4
- 设置 Node.js 版本为 22
- 启用 npm 缓存
安装依赖：
- 启用 corepack
- 使用 npm ci --legacy-peer-deps 安装依赖
构建文档：
- 设置 NODE_OPTIONS: --max_old_space_size=8192，增加 Node.js 内存限制
- 运行 npm run docs:build 构建文档
- 创建 .nojekyll 文件，避免 GitHub Pages 使用 Jekyll 处理
部署文档：
- 使用 JamesIves/github-pages-deploy-action@v4
- 部署到 gh-pages 分支
- 部署目录为 src/.vuepress/dist

成功完成所有步骤：所有 9 个步骤都成功执行
合理的运行时间：总运行时间为 2 分 15 秒，其中：
- Checkout 步骤耗时较长（1m 33s），这是正常的，因为需要克隆仓库
- 构建文档步骤耗时 19s，速度合理
- 部署步骤仅耗时 3s，速度很快
配置合理：
- 触发条件设置正确，仅在必要时运行
- 权限设置适当，仅授予必要的写入权限
- 依赖安装使用 npm ci，确保依赖版本的一致性
- 构建时增加了内存限制，避免构建过程中内存不足
- 部署配置正确，指向正确的分支和目录

Checkout 时间：
- 可以考虑使用 actions/checkout@v4 的 persist-credentials: false 选项，减少不必要的凭据存储
- 对于大型仓库，可以考虑使用 fetch-depth: 1 减少克隆时间，但可能会影响某些需要完整历史的操作
依赖安装：
- 可以考虑使用缓存机制，进一步加快依赖安装速度
- 例如使用 actions/cache 缓存 node_modules 目录
构建过程：
- 可以考虑使用并行构建，加快构建速度
- 对于大型项目，可以考虑使用增量构建

GitHub Action Workflow 运行状态正常，配置合理，执行效率良好。所有步骤都成功完成，运行时间在合理范围内。