我之前也碰到过一模一样的情况，结合你的描述来看，核心问题就是GitHub Pages没有自动把根路径 https://[me].github.io/[appName]/ 指向根目录的index.html文件——既然直接访问该文件能正常加载，说明你的资源位置和功能都没问题，咱们一步步来解决：

1. 重新确认GitHub Pages的源配置 #

进入仓库的Settings > Pages页面，检查这两点：

• 确认Source选择的是gh-pages分支，且目录是/root（不是/docs或者其他子文件夹）
• 页面顶部显示的「Your site is published at...」地址和你访问的一致。如果没问题，试着点击一下Save按钮重新触发发布流程——有时候GitHub的缓存会导致路径映射更新延迟。

2. 验证index.html的位置 #

确保gh-pages分支里的index.html确实在仓库根目录下，而不是嵌套在/public、/build这类子文件夹里。你可以直接在GitHub上浏览gh-pages分支的文件列表，确认index.html处于最顶层。

3. 强制清除浏览器缓存 #

浏览器可能缓存了旧的404响应，试试用Ctrl + Shift + R（Windows/Linux）或者Cmd + Shift + R（Mac）强制刷新根路径页面，跳过本地缓存重新从GitHub拉取最新内容。

4. 添加_config.yml文件（针对静态站点生成工具） #

如果你是用Jekyll这类静态站点生成工具构建项目的，在gh-pages分支的根目录添加一个_config.yml文件，明确指定默认索引文件：

permalink: /
defaults:
  - scope:
      path: ""
    values:
      layout: "default"
      index: "index.html"

提交这个文件到gh-pages分支，让GitHub重新发布站点——这能确保平台正确识别你的首页文件。

5. 检查自定义域名配置（如果有） #

如果你给GitHub Pages配置了自定义域名，确认gh-pages根目录下的CNAME文件里的域名正确，且DNS解析已经生效。不过你的问题中直接访问index.html没问题，所以这个可能性较低，但如果前面的步骤都没解决，可以顺便排查一下。

按照这些步骤操作后，根路径应该就能自动加载index.html，不会再出现404错误了。

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