GitHub Pages未显示在线链接，gh-pages分支选项缺失求助

我已将应用上传至GitHub仓库，但Pages页面未显示“your app is live at...”的在线链接，且分支选择下拉菜单中也没有gh-pages选项。操作步骤如下：

1. 创建仓库后执行git init、git add .等命令推送到main分支；
2. 安装gh-pages依赖；
3. 在package.json中添加homepage、predeploy和deploy配置；
4. 提交代码并执行npm run deploy。

此前部署小型应用均正常，但本次多页面项目仅能看到代码，无法查看在线版本，请问哪里操作有误？

1. 检查npm run deploy执行日志 #

执行部署命令时，仔细查看终端输出的日志信息：

• 若出现权限报错，确认本地Git账号对该仓库有读写权限，或检查仓库是否为私有且权限配置异常；
• 若出现构建失败提示，说明多页面项目的路由、打包配置存在问题，导致gh-pages分支无法正常生成。

2. 验证package.json配置准确性 #

多页面项目的配置需要更严谨，重点检查以下几点：

• homepage格式必须正确，示例："homepage": "https://<你的GitHub用户名>.github.io/<仓库名>"；
• deploy命令要匹配打包输出目录：比如React项目用"deploy": "gh-pages -d build"，Vue项目需改为"deploy": "gh-pages -d dist"；
• predeploy命令要确保能触发正确的打包流程，比如"predeploy": "npm run build"，如果项目打包命令不是npm run build，需对应修改。

3. 确认本地gh-pages分支状态 #

在本地终端执行git branch查看分支列表：

• 若没有gh-pages分支，说明部署命令未成功创建分支，需排查打包或gh-pages工具的运行问题；
• 若本地存在gh-pages分支，执行git push origin gh-pages手动推送至远程，之后刷新GitHub Pages页面重新查看。

4. 排查多页面项目打包配置 #

多页面项目的默认打包配置可能不兼容GitHub Pages：

• 若使用history路由模式，需添加404页面适配GitHub Pages规则，或切换为hash模式；
• 确保打包后的静态资源路径设为相对路径，避免资源加载失败；
• 检查打包输出目录（如build/dist）是否包含所有页面的静态文件，无遗漏。

5. 手动配置GitHub Pages #

进入仓库的Settings -> Pages页面：

• 在Source区域，选择Branch为gh-pages（推送成功后会显示该选项），并选择根目录（/root），点击Save；
• 等待3-5分钟，GitHub会重新构建Pages服务，之后即可看到在线访问链接。

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