Jekyll搭建GitHub Pages博客图片不显示问题求助

API 探路者

2026-7-7

解决方案

修正图片引用路径
你的文章发布后URL层级为/blog/2023/10/23/Delivery-Time-Prediction，直接用相对路径nom_dist.png会让浏览器在当前文章目录下查找图片，而你的图片实际存放在/assets目录，需改用根路径引用：
```
![nominal_distribution](/assets/nom_dist.png)
```
若你的站点配置了baseurl（比如仓库名称），建议用Jekyll变量适配，避免路径错误：
```
![nominal_distribution]({{ site.baseurl }}/assets/nom_dist.png)
```
移除多余的include配置
_posts是Jekyll默认自动包含的目录，无需在_config.yml中添加include: - "_posts"，该配置对图片问题无帮助，还可能引发路径干扰，建议删除该行恢复默认配置。
本地预览验证路径
执行bundle exec jekyll serve启动本地服务，打开生成的文章页面，右键检查图片元素，查看src属性是否正确指向/assets/nom_dist.png。若路径错误，说明引用写法仍有问题；若路径正确但本地也不显示，检查图片是否确实放在项目根目录的/assets文件夹下。
确认图片存放位置
确保nom_dist.png存放在项目根目录的/assets文件夹中，而非_posts目录下。Jekyll不会自动将_posts内的静态文件复制到生成的站点目录，统一放在/assets是Jekyll推荐的静态资源管理方式。