GitHub Pages自定义部署流程及配置问题咨询

操作指引获取位置 #

你不需要跳转外部站点找指引，直接打开对应仓库的Settings -> Pages页面，就能看到所有官方内置的自定义部署操作说明，覆盖从配置源到自定义工作流的全场景说明。

已完成两步后的剩余必要操作 #

你已经完成添加.nojekyll文件、配置代码检出与html文件域名替换这两步，还需要补全以下流程才能正常部署：

• 替换脚本执行完成后，新增产物上传步骤：将处理完成的整个站点根目录（包含html、css、js、图片等所有静态资源）作为部署产物上传，注意路径要匹配你站点的实际文件结构，不要遗漏资源文件夹。
• 修改Pages部署源配置：进入仓库Settings -> Pages页面，将Source选项从默认的分支部署切换为GitHub Actions，否则你写的替换脚本不会在部署流程中触发。
• 补全Workflow权限：在你写的Actions工作流文件顶层，配置pages: write和id-token: write两项权限，否则部署时会报无操作权限的错误。
• 新增最终部署步骤：在替换、上传产物的步骤之后，调用官方Pages部署动作发布上传的产物，这一步执行完成后站点内容才会正式上线。

小提示：写替换脚本的时候不要只匹配.html后缀文件，如果你的站点sitemap、rss、js、css文件里也存在foo.com字段，记得把这些后缀也加入匹配范围，避免出现部分资源仍指向旧域名的问题。

自定义.github目录的影响 #

你自行添加的.github目录不会遮蔽、覆盖站点部署所需的必要Action。
你在仓库内创建的.github/workflows路径下的自定义工作流，和GitHub Pages内置部署能力是兼容的：只要你没有使用GitHub保留的工作流文件名、没有写阻断官方触发逻辑的错误配置，就不会出现冲突。当你把部署源切到GitHub Actions之后，你写的自定义工作流本身就是部署流程的组成部分，和内置能力是配合运行的关系。

关于你提到的Jekyll方案 #

你选择不用Jekyll的思路完全可行：只要仓库根目录存在.nojekyll文件，GitHub Pages就会直接跳过Jekyll构建流程，不需要给任何文件添加front matter，整个流程只跑你自己写的替换逻辑，没有额外冗余，完全适配你只需要做单字段替换的场景。

内容的提问来源于stack exchange，提问作者Zack