hexo博客上传github图片不显示

Question

在hexo本地博客上可以看到，但在github上看不到图片怎么回事

Answer 1

让【宝码香车】来帮您解答，本回答参考DeepSeek编写，并整理提供。

如果答案让您满意，请采纳、点赞、关注，非常感谢！
.
每日一句正能量，让它带给您好心情：生活就像一杯白开水，你往里面加什么，它就是什么味道。
.

Hexo博客图片在GitHub Pages不显示的解决方案

根据您的描述，Hexo本地博客图片显示正常，但在GitHub Pages上无法显示，这是常见问题。以下是几种可能的原因和解决方案：

1. 图片路径配置问题

检查Hexo配置文件

在Hexo根目录的_config.yml中，确保post_asset_folder设置为true：

post_asset_folder: true

这样每篇博客会自动创建同名文件夹存放图片。

正确的图片引用方式

在Markdown文件中，使用以下方式引用图片：

![图片描述](图片文件名.jpg)

或者使用Hexo标签语法：

{% asset_img 图片文件名.jpg 图片描述 %}

2. 相对路径与绝对路径问题

确保使用相对路径

• 不要使用绝对路径如/images/xxx.jpg
• 确保图片文件与Markdown文件在同一目录或正确相对位置

3. GitHub Pages缓存问题

清除GitHub缓存

GitHub Pages有缓存机制，可以尝试：

# 在本地清除缓存后重新部署
hexo clean
hexo generate
hexo deploy

4. 检查图片文件是否上传

确认图片文件已提交

确保图片文件已添加到Git仓库：

git add source/_posts/你的文章文件夹/图片文件.jpg
git commit -m "添加图片"
git push

5. 检查GitHub仓库设置

验证GitHub Pages设置

1. 进入GitHub仓库 → Settings → Pages
2. 确认Source设置为正确的分支（通常是gh-pages或main）
3. 确保自定义域名配置正确（如果有）

6. 网络和CDN问题

检查图片URL

在GitHub Pages页面按F12打开开发者工具：

• 查看Console是否有404错误
• 检查Network标签页中图片请求的状态

7. 推荐的解决方案流程

# 1. 清理并重新生成
hexo clean


# 2. 生成静态文件
hexo g


# 3. 本地预览检查
hexo s


# 4. 确认本地正常后部署
hexo d

8. 使用图床替代方案

如果上述方法仍不奏效，可以考虑使用图床：

• 将图片上传到图床（如Imgur、SM.MS等）
• 在Markdown中使用图床的图片链接

如果问题仍然存在，请提供具体的错误信息和图片引用方式，我可以提供更针对性的解决方案。