使用GitHub Pages搭建Helm仓库执行helm repo add时报YAML转换错误

问题原因 #

报错提示YAML第188行存在不允许的映射值，说明Helm客户端实际拉取到的index.yaml并非你预期的纯YAML内容，存在格式损坏。你手动在浏览器访问看到的是短片段，实际完整返回的文件大概率被GitHub Pages默认的Jekyll构建逻辑注入了额外内容，导致整体格式不符合YAML规范。

优先解决方法 #

在你部署GitHub Pages的分支（通常为gh-pages分支）根目录下，新增一个名为.nojekyll的空文件，提交推送后等待GitHub Pages完成重新部署，再尝试执行helm repo add命令即可。
该文件的作用是告知GitHub Pages跳过Jekyll静态站点构建流程，直接返回原始静态文件，避免YAML被注入HTML代码、统计脚本、页脚内容等无关信息破坏格式。这一方法可以解决90%以上的同类问题。

未解决时的排查步骤 #

• 拉取完整的index.yaml验证格式
  执行以下命令拉取完整的原始返回内容：

  curl https://didactic-quibble-e0daddd0.pages.github.io/index.yaml > actual_index.yaml
  

  打开下载的actual_index.yaml文件，定位到第188行排查语法问题，常见错误包括：空值字段冒号后未留空格、特殊字符未用引号包裹、缩进错误、末尾追加了非YAML内容，找到问题后修正index.yaml的生成逻辑即可。
• 确认仓库地址正确性
  如果你使用的是项目级GitHub Pages（非用户名根站点），需要在地址末尾补充仓库名，正确格式为https://<用户名>.github.io/<仓库名>/，避免路径错误拉取到404页面等非YAML内容。
• 检查版本兼容性
  确认本地Helm版本与生成index.yaml使用的chart-releaser、helm package命令的版本兼容，避免不同版本对YAML规范的解析差异导致报错。

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