Jekyll+Github Pages站点Welcome to Jekyll文章图片404问题求助
2026-9-27
问题根因
你在_config.yml中配置了baseurl: "blogubb"，说明站点实际部署在域名的/blogubb子路径下，但你在文章中使用这种根绝对路径写图片地址，浏览器解析时会直接从域名根https://kuolai.github.io/开始拼接路径，最终请求的是不存在的https://kuolai.github.io/assets/img/kitty.png，所以返回404错误。
如果首页、关于页使用同样的路径却显示正常，大概率是你实际在这两个页面中写的是不带前置斜杠的相对路径，浏览器会基于当前页面路径拼接，刚好匹配到正确的图片地址。
解决方案
方案1：使用Jekyll内置变量拼接路径（最推荐）
把文章中的图片写法替换为：
Jekyll构建时会自动把{{ site.baseurl }}替换为你配置的/blogubb，后续如果修改baseurl配置，不需要手动调整所有图片路径。
方案2：手动补全baseurl前缀
直接写全站点子路径的绝对地址：
该方案缺点是如果后续修改baseurl配置，需要手动调整所有图片路径。
方案3：使用相对路径
根据文章最终生成的访问路径深度，回退到站点根目录再访问图片：
该方案缺点是如果修改文章永久链接规则、分类层级，相对路径会直接失效，不推荐使用。
内容的提问来源于stack exchange，提问作者kuolai shu
相关产品推荐
相关产品推荐
