起因

刚写完第一篇文章满怀期待的上传，然后 Hexo 给了我个惊喜 ———— 没有图片！

文章中图片无法显示

使用 Markdown 插入本地图片时Hexo渲染的静态页面中的图片路径错误

使用 Markdown 插入图片：![](./Hexo自动化部署/DeployKeys位置.png)

解决方案

在 Hexo/_config.yml 中修改 post_asset_folder 配置为 true ，将每篇博客的资源文件单独放置在与文章同名的文件夹中

post_asset_folder: true
使用 hexo-asset-image 给 hexo 中的资源图片指定绝对路径
在控制台中输入 npm install hexo-asset-image --save 安装

由于 hexo-asset-image 太久未维护，直接使用会有些问题
所以还需要在 Hexo/_config.yml 中修改 permalink 配置
1
2
# permalink: :year/:month/:day/:title/
permalink: :year/:month/:day/:title.html
使博客的链接地址显示 .html 后缀

注意事项

使用 GitHub Actions 时如果添加的插件没有生效可以检查一下网站中的 package.json 是否存在，如果不存在需要修改工作流配置，将 判断是否已缓存 暂时注释，来让 GitHub Actions 安装 hexo-asset-image

成功！

封面显示设置

在 _config.yml 中开启 post_asset_folder 后 Hexo 文章封面的路径是 permalink 中设置的路径 + 图片名

# Url
permalink: :year/:month/:day/:title.html

# 封面   year/month/day/title/图片名
cover: ./2023/10/09/4089126318/404封面.png

hexo-abbrlink

推荐使用 hexo-abbrlink 将网页链接的标题部分转为十六进制，这样在分享网页过程中可以避免链接中包含中文导致超链接显示不全等问题
安装：npm install hexo-abbrlink --save

配置

使用 npm 安装

在 _config.yml 中添加 hexo-abbrlink 配置

# Url
# - permalink: :year/:month/:day/:title.html
# + permalink: :year/:month/:day/:abbrlink.html
permalink: :year/:month/:day/:abbrlink.html

# abbrlink config 使用 dec 可将标题转为十进制
abbrlink:
   alg: crc32      #support crc16(default) and crc32
   rep: dec        #support dec(default) and hex