You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Github Pages部署后仅index.html可访问,其余页面无法加载求助

解决GitHub Pages部署后页面链接无响应问题

按以下步骤逐一排查解决:

1. 核对链接路径与文件名大小写

  • 确保所有<a>标签的href使用相对路径,比如跳转about.html要写href="about.html"或href="./about.html",别用绝对路径(如href="/about.html",自定义域名根目录配置正确除外)。
  • GitHub严格区分文件名大小写,本地Windows系统不区分,比如你本地文件是About.html但链接写about.html,本地能打开但GitHub Pages会解析失败。务必让链接里的路径和仓库中文件名完全一致,包括大小写。

2. 处理含特殊字符的文件名

你的books&travel.html包含&特殊字符,本地能识别但部署后可能导致路径解析异常。建议:

  • 将文件名改为无特殊字符的格式,比如books-and-travel.html,同时同步更新所有<a>标签里的href值。

3. 确认GitHub Pages部署配置

  • 进入仓库的「Settings」→「Pages」,检查「Source」区域:
    • 确认选择的分支是你上传代码的分支(比如main)。
    • 确认目录选择「/root」(如果HTML文件都在仓库根目录),不要选「/docs」等其他目录。
  • 部署完成后等待几分钟(GitHub Pages存在延迟),再刷新页面测试链接。

4. 查看浏览器控制台错误信息

右键页面→「检查」→切换到「Console」标签,点击无响应的链接,查看是否有报错(如404、路径解析错误),这些信息可直接定位问题。


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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.29 02:05:57