You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何查找管控GitHub Pages构建与部署任务的YAML文件?

GitHub Pages 构建部署配置文件定位指引

一、配置文件的默认存放路径

  • 「Pages Build and Deployment」对应的GitHub Actions配置文件(YAML格式),默认放在仓库根目录的 .github/workflows/ 文件夹下,文件名一般是 github-pages.yml(GitHub自动生成的),也可能是你自定义的 pages.yml、deploy.yml 这类名称。
  • 至于 _config.yml,那是Jekyll等静态站点生成器的站点配置文件,同样在仓库根目录,但它管的是站点内容生成逻辑,不是部署任务的配置。

二、从GitHub仓库界面快速找到配置文件

  • 打开你的仓库,点顶部的「Actions」标签页,左侧工作流列表里找带「Pages Build and Deployment」字样的工作流,点进去后,在「Workflow file」区域就能看到配置文件的路径和完整内容。
  • 要是之前是通过仓库设置页配置的Pages,直接去「Settings」→「Pages」→「Build and deployment」板块,看「Source」选项,如果选的是「GitHub Actions」,点旁边的「Configure」按钮,就能直接进入配置文件的查看/编辑页面,同时也能看到它的存放路径。

三、给纯HTML项目新手的配置建议

  • 纯HTML项目其实不用写自定义YAML,直接去仓库「Settings」→「Pages」,把「Source」设为「Deploy from a branch」,选好存放HTML的分支(比如main)和目录(根目录/root或者docs),保存后GitHub会自动完成部署。
  • 如果需要自定义部署流程(比如加文件压缩、预部署测试),可以在 .github/workflows/ 下新建 github-pages.yml 文件,复制下面的代码提交即可:
name: Deploy to GitHub Pages

on:
  push:
    branches: ["main"]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Pages
        uses: actions/configure-pages@v4

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: '.'

      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

内容的提问来源于stack exchange,提问作者NanoNet

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.11 09:12:31