GitHub Pages部署异常：目标URL 404却生成子路径页面

问题原因 #

GitHub Pages 的域名规则分为两种：

• 用户/组织站点：仅当仓库名与你的用户名/组织名完全一致时，才能通过 https://<用户名>.github.io 访问。你的用户名是 shouttolearnorg，因此对应的用户站点仓库必须命名为 shouttolearnorg.github.io。
• 项目站点：任意名称的仓库部署后，访问路径为 https://<用户名>.github.io/<仓库名>。你创建的 shouttolearn.github.io 属于项目站点，因此只能通过 https://shouttolearnorg.github.io/shouttolearn.github.io/ 访问。

而 https://shouttolearn.github.io 这个域名，仅属于用户名为 shouttolearn 的用户——只有该用户创建同名仓库，才能将其作为用户站点使用。你当前的用户名无权限直接使用这个默认域名，因此访问时会返回404。

解决方案 #

根据你的需求，提供两种可行方案：

方案一：使用自身用户站点域名（推荐）

1. 进入 shouttolearn.github.io 仓库的「Settings」页面，找到「Repository name」选项，将仓库名修改为 shouttolearnorg.github.io，保存更改。
2. 在仓库设置的「Pages」板块，确认「Source」选择的是正确分支（通常为 main）和根目录 /(root)，点击「Save」重新触发部署。
3. 等待10-30分钟（GitHub部署与DNS解析需要时间），之后访问 https://shouttolearnorg.github.io 即可正常打开站点。

方案二：使用自定义域名 shouttolearn.github.io（需域名控制权）

1. 确认你已拥有 shouttolearn.github.io 域名的管理权限（注：GitHub官方的 github.io 子域名仅对同名用户开放，若你不是 shouttolearn 用户，需自行注册独立域名并配置）。
2. 进入 shouttolearn.github.io 仓库的「Pages」设置，在「Custom domain」输入框中填入目标域名并保存。
3. 配置该域名的DNS记录：添加一条CNAME记录，指向 shouttolearnorg.github.io。
4. 等待DNS解析完成（通常1-24小时），GitHub会自动完成部署，之后即可通过 https://shouttolearn.github.io 访问。

额外检查点 #

• 确保仓库根目录下存在 index.html 文件，且文件路径、内容无错误。
• 若部署后仍有问题，可在仓库「Pages」页面查看部署日志，排查具体错误。

内容的提问来源于stack exchange，提问作者ASHISH KUMAR