如何让GitHub Pages优先加载文件夹中的index.html而非readme？

通用配置调整（核心步骤） #

• 打开你的GitHub项目仓库，点击顶部的「Settings」选项
• 找到左侧菜单栏里的「Pages」，在「Source」板块：
  • 选好部署用的分支（一般是main或gh-pages分支）
  • 展开「Folder」下拉框，选择你的index.html所在的构建输出文件夹（比如Angular的dist/项目名、Node.js项目的build/public）
  • 点击「Save」，等待几分钟让GitHub重新部署，再访问地址就能加载站点了

Node.js项目适配（以weather-app为例） #

• 先确认项目有正确的构建脚本：打开package.json，在scripts里添加或完善构建命令，比如用Webpack打包的话，脚本可能是：

  "scripts": {
    "build": "webpack --mode production"
  }
  

• 本地执行npm run build生成构建产物，确保产物都集中在同一个文件夹（比如build）
• 再按通用步骤，在GitHub Pages设置里选择这个构建文件夹作为部署源

Angular项目适配（以angular-store-为例） #

• Angular项目构建后，产物默认放在dist/你的项目名文件夹里，先执行构建命令：

  ng build --base-href "/angular-store-/"
  

  这里的--base-href参数必须和你的GitHub仓库名称一致，否则路由会出现异常
• 然后到GitHub Pages设置里，选择dist/angular-store-（对应你的项目名）作为部署文件夹
• 保存后等待部署完成即可正常访问

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