Angular项目部署至GitHub Pages失败问题求助

1. 修正构建命令 #

你当前的ng build命令格式错误，直接追加GitHub仓库地址是无效的。正确的构建命令需要指定--base-href参数（匹配GitHub Pages的访问路径）：

ng build --configuration production --base-href "/"

如果你的GitHub Pages访问路径是https://GogaTsutsunava.github.io/website.github.io/（即仓库非用户名.github.io类型的个人主页仓库），则--base-href需改为"/website.github.io/"。

执行命令后，检查dist/website.github.io目录，确认里面包含完整构建产物：index.html、assets文件夹、js、css、media等子目录及文件。

2. 重新部署到gh-pages分支 #

确保angular-cli-ghpages已正确安装，执行部署命令：

ngh --dir dist/website.github.io

留意命令行输出，确认无报错且所有文件已推送到gh-pages分支。

3. 检查gh-pages分支与部署设置 #

• 登录GitHub查看gh-pages分支，确认分支根目录直接存放构建后的所有文件（而非嵌套dist文件夹）
• 进入仓库Settings -> Pages，确认Build and deployment的Source选择了gh-pages分支及根目录

常见排查点 #

• 确认ng build执行无报错，dist目录文件完整
• 清除浏览器缓存后重新访问页面，避免缓存导致的显示异常

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