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

GitHub托管HTML文件异常:上传后页面仅显示‘rural’,求排查

解决GitHub Pages只显示'rural'的问题

看起来你在GitHub Pages托管HTML时遇到了小麻烦,我帮你梳理几个最可能出错的地方,你可以逐一排查:

  • 检查GitHub Pages的部署源设置
    首先去仓库的「Settings」→「Pages」页面,确认「Source」部分选择的分支和目录是否正确。GitHub Pages默认会从maingh-pages分支的根目录(或者指定的docs文件夹)读取页面文件。如果你的HTML文件放在了子文件夹里,或者选错了分支,就会导致加载不到正确内容,可能显示仓库名称(这里的'rural'大概率就是你的仓库名)。

  • 确认主页文件名是否为index.html
    GitHub Pages默认把index.html当作站点的主页文件。如果你的HTML文件叫别的名字(比如home.html),访问仓库的Pages地址时,系统找不到主页,就可能只显示仓库名或者空白。解决办法很简单:把你的主页HTML重命名为index.html,或者在Pages设置里指定自定义的主页文件名(不过用默认的index.html最省心)。

  • 检查HTML文件本身的内容
    去你的GitHub仓库里打开那个HTML文件,看看内容是不是你要展示的完整代码,而不是只有'rural'这几个字。有时候上传文件时可能出了问题,比如文件损坏或者传错了文件,这种情况重新上传正确的HTML文件就行。

  • 清除浏览器缓存或等待部署完成
    GitHub Pages部署有时候会有延迟,或者浏览器缓存了旧内容。你可以试试强制刷新页面(Windows按Ctrl+F5,Mac按Cmd+Shift+R),或者等个5-10分钟再访问,说不定页面就正常显示了。

  • 确认访问地址是否正确
    如果这是个普通仓库(不是<你的用户名>.github.io这种用户主页仓库),正确的访问地址应该是https://<你的用户名>.github.io/<仓库名>,也就是https://xxx.github.io/rural。如果你直接访问了<你的用户名>.github.io,那自然看不到你这个仓库里的页面,反而可能显示仓库列表或者仓库名。

内容的提问来源于stack exchange,提问作者hased

火山引擎 最新活动