如何设置GitHub Pages默认打开index.html而非README.md?
如何让GitHub Pages默认打开index.html而非README.md
别发愁,这个问题其实很容易解决,我来一步步教你:
方法1:检查并确认GitHub Pages的部署设置
首先确保你的Pages配置正确指向了包含index.html的路径:
- 打开你的仓库主页,点击顶部的「Settings」选项卡
- 在左侧菜单栏找到「Pages」(通常在「Code and automation」分类下)
- 在「Build and deployment」区域,确认Source选择的是
gh-pages分支,且Root目录(如果有选项的话)是根目录(/) - 保存设置后,等待几分钟让GitHub重新部署,然后刷新Pages页面看看是否生效
方法2:强制指定默认页面(如果方法1没生效)
如果index.html确实在根目录但还是优先加载README,可以通过添加配置文件来强制:
在gh-pages分支的根目录创建一个名为_config.yml的文件,里面写入:
defaults: - scope: path: "" values: permalink: / layout: default
提交这个文件到gh-pages分支,等待部署完成后再访问试试。
方法3:临时快速解决(可选)
如果你着急看到效果,也可以在README.md的最顶部添加一段自动跳转代码,访问README时会自动跳转到index.html:
<meta http-equiv="refresh" content="0; url=./index.html">
不过这只是临时方案,还是推荐前两种方法从根本上解决问题。
另外要注意:GitHub Pages有时候会有缓存,如果你已经改了设置但没看到变化,可以尝试用无痕浏览器打开,或者等待10-15分钟让缓存更新。
内容的提问来源于stack exchange,提问作者Ricardo Moreira




