GitHub Pages部署问题：点击链接仅显示仓库名，无法查看项目

1. 检查项目根目录的入口文件 #

GitHub Pages默认优先加载根目录下的index.html（静态站点场景），如果根目录没有这个文件，就会显示仓库默认页面（仅展示仓库名）。对照你的项目代码截图确认：

• 纯静态项目：确保index.html在根目录，不要放在子文件夹内
• Vue/React这类框架项目：先执行打包命令生成dist（或build）文件夹，再将打包后的文件推送到仓库，或者在GitHub Pages设置里指定/dist作为发布来源

2. 确认GitHub Pages的发布配置 #

进入仓库「Settings」→「Pages」页面：

• 检查「Source」区域，除了选择main分支，还要确认下方的「Folder」选项是否正确：
  • 静态文件在根目录就选/(root)
  • 文件在dist或build文件夹就选对应路径
• 保存设置后，等待5-10分钟让GitHub重新部署

3. 核对仓库文件结构 #

确认项目文件已正确推送到main分支：

• 打开仓库主页，检查根目录是否有正确的静态资源（比如index.html、css、js文件夹等），而不是只有框架源码（比如Vue的src文件夹）
• 框架项目需先本地执行打包命令：
  • Vue项目：npm run build
  • React项目：npm run build
    之后将生成的dist/build文件夹内容推送到仓库根目录，或者调整GitHub Pages的发布文件夹为dist

4. 查看部署日志排查问题 #

在「Settings」→「Pages」页面最下方的「Deployment history」里，点击最新部署记录查看日志，确认是否存在入口文件缺失、权限报错等问题

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