新手求助：GitHub Pages无法打开子文件夹内的index.html文件

检查GitHub Pages发布源设置 #

• 进入仓库的Settings -> Pages页面，确认Source区域的配置：
  • 若选择Deploy from a branch，需核对分支（如main）和目录设置。如果目标index.html在子文件夹（比如docs/或task/），要把默认的/root改成对应子文件夹路径。
  • 若选择GitHub Actions，检查工作流文件是否正确指定了子文件夹作为发布目录。

确认子文件夹文件结构 #

• 确保index.html直接放在目标子文件夹下，没有嵌套更深层级。
• 检查文件名：必须是小写的index.html，GitHub Pages对文件名大小写敏感，避免写成Index.html或INDEX.HTML。

验证仓库访问权限 #

• 如果是私有仓库，确认你拥有GitHub Pages访问权限（私有仓库的Pages功能需要GitHub Pro/Team/Enterprise权限，或你是仓库所有者/协作者）。

等待部署完成 #

• 修改设置或推送文件后，GitHub Pages需要几分钟完成部署。可在Settings -> Pages页面查看状态，显示Your site is live at ...才代表部署完成。

正确访问子文件夹URL #

• 部署完成后，访问格式为：https://<你的用户名>.github.io/<仓库名>/<子文件夹名>/，注意末尾斜杠不能省略，比如子文件夹是demo，就访问https://xxx.github.io/repo/demo/，系统会自动加载该文件夹下的index.html。

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