You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

如何设置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

火山引擎 最新活动