GitHub Pages生成失败，如何上传个人站点求分步操作指导？

前期准备 #

• 拥有可正常登录的GitHub账号
• 提前准备好静态站点文件，必须包含入口文件index.html；如果是前端框架构建的项目，请先执行打包命令生成完整的静态资源包

第一步：创建Pages专用仓库 #

• 登录GitHub后，点击页面右上角「+」号，选择「New repository」创建新仓库
• 仓库命名必须严格遵循「你的GitHub用户名.github.io」规则，大小写要和你的GitHub用户名完全一致，比如用户名为lisi，仓库名就必须是lisi.github.io，命名错误会导致Pages服务无法正常识别
• 仓库权限选择Public，可按需勾选「Add a README file」，完成后点击「Create repository」

第二步：上传站点文件 #

方式1：网页端上传（无Git基础推荐） #

• 进入刚创建的仓库页面，点击「Add file」按钮，选择「Upload files」
• 打开本地站点文件所在的目录，选中目录内的所有文件（注意不要直接上传外层目录本身），拖拽到网页上传区域，也可以点击「choose your files」批量选择
• 下拉到页面底部，点击「Commit changes」完成上传

方式2：Git命令上传（有Git基础推荐） #

• 本地打开终端/命令行工具，进入站点文件所在目录，依次执行以下命令：

# 初始化本地Git仓库
git init
# 关联远程仓库，将命令中两处「你的用户名」替换为你自己的GitHub用户名
git remote add origin https://github.com/你的用户名/你的用户名.github.io.git
# 添加所有站点文件
git add .
# 提交文件
git commit -m "上传站点文件"
# 推送到远程main分支
git push -u origin main

第三步：开启Pages服务配置 #

• 回到仓库页面，点击顶部导航栏的「Settings」（设置）选项
• 左侧菜单下滑找到「Code and automation」分类下的「Pages」选项，点击进入配置页
• 在「Build and deployment」区域的「Source」下拉框，选择「Deploy from a branch」
• 下方「Branch」配置项，第一个下拉框选择你上传文件的分支（默认是main，部分旧仓库为master），第二个下拉框选择/root，点击「Save」保存配置

第四步：验证部署结果 #

• 保存配置后等待1-3分钟，GitHub会自动完成站点部署
• 部署完成后在浏览器访问https://你的用户名.github.io，即可正常访问你的站点

提示：如果访问出现404，先检查仓库命名、分支选择是否正确，也可以清除浏览器缓存后重试；如果是框架构建的站点出现资源加载失败，检查打包时的公共路径配置是否正确。

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