GitHub Pages显示HTML源码未渲染,配置存在什么缺失?
GitHub Pages显示原始HTML标签的排查方案
以下是可能导致该问题的原因及解决方法:
- 文件编码异常:确保
index.html以UTF-8编码保存,非UTF-8编码的文件可能被GitHub Pages识别为纯文本而非HTML文件。 - HTML标签被转义:检查文件内容,确认你没有把原生的
<、>标签误写成<、>这类转义字符,这类转义字符会被浏览器当作普通文本渲染。 - Jekyll构建干扰:如果仓库的GitHub Pages设置中默认启用了Jekyll构建,它可能会错误解析纯HTML文件。在仓库根目录添加一个空的
.nojekyll文件,可强制GitHub Pages按静态HTML文件直接部署,跳过Jekyll处理。 - 文件名或类型错误:确认文件名是小写的
index.html(GitHub Pages对文件名大小写敏感),且文件确实是HTML格式,没有被标记为纯文本类型。
内容的提问来源于stack exchange,提问作者user938363
相关产品推荐
相关产品推荐

