如何阻止GitHub Pages对静态HTML仓库执行Jekyll构建？

这个问题我碰到过好几次了，其实解决起来很简单，有两种常用的方法可以让GitHub跳过Jekyll构建流程，直接部署你的静态HTML内容：

方法1：添加.nojekyll空文件 #

GitHub默认会自动检测仓库内容，尝试用Jekyll构建静态站点。只要在仓库根目录放一个空的.nojekyll文件，就能明确告诉GitHub："不用麻烦Jekyll了，直接部署我的静态文件就行"。

操作步骤：

• 在本地项目的根目录创建一个空文件，命名为.nojekyll（注意文件名开头的点，文件里不需要写任何内容）
• 将这个文件提交到Git仓库，然后推送到GitHub
• 可以去仓库的「Pages」设置页面手动点击「重新部署」按钮，或者再推送一次代码触发部署

方法2：修改GitHub Pages的构建来源设置 #

如果不想添加额外文件，也可以直接通过仓库设置来关闭Jekyll构建：

操作步骤：

• 打开你的GitHub仓库，点击顶部的「Settings」选项卡
• 向下滚动找到「Pages」板块
• 在「Build and deployment」区域的「Source」下拉菜单中，选择「Deploy from a branch」
• 接着在「Branch」选项里，选择你存放静态文件的分支（比如main）和对应的目录（一般选根目录/root）
• 保存设置后，GitHub会直接部署该分支下的静态内容，不会再触发Jekyll的构建流程

如果之前有过构建失败的记录，设置完成后记得手动触发一次重新部署，确保新的配置生效。

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