Angular网站部署至Github Pages失败，执行ngh命令报错求助

这个报错核心是angular-cli-ghpages工具找不到你指定的编译产物目录，和--base-href参数无关，不需要继续调整该参数，按以下步骤排查即可：

• 第一步：确认编译产物实际路径
  执行完ng build命令后，打开项目根目录下的dist文件夹，逐层查看内部结构：
  Angular 14及以后的版本默认会在项目名下新增一层browser目录，index.html实际存放路径为dist/[你的项目名]/browser/index.html，而非你填写的dist/[你的项目名]
• 第二步：调整ngh命令的目录参数
  把--dir参数的值替换为index.html所在目录的相对路径（从项目根目录开始计算），例如确认index.html在dist/my-angular-app/browser下，就执行以下命令：

  ngh --dir=dist/my-angular-app/browser
  

• 可选简化方案：修改编译输出路径
  打开项目根目录的angular.json文件，找到projects -> 你的项目名 -> architect -> build -> options下的outputPath配置，默认值为dist/[你的项目名]，你可以直接修改为dist，后续执行ng build后编译产物会直接生成在dist根目录，直接执行ngh --dir=dist即可部署，不需要再嵌套查找目录。
• 额外检查项：
  执行ngh命令时必须在项目根目录（和angular.json文件同目录），不要进入子文件夹后执行命令。

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