如何查找管控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
相关产品推荐
相关产品推荐

