博客功能更新 —— 固定文章短链

安装了hexo-abbrlinkHexo 插件,用于为每篇文章生成唯一且固定的短链接,避免因标题或日期修改导致 URL 失效,同时优化 SEO 和链接简洁度。

安装插件

1
npm install hexo-abbrlink --save

修改 _config.yml 将默认的 permalink 改为使用 abbrlink:

1
permalink: /:abbrlink.html

配置参数

_config.yml 文件中添加:

1
2
3
4
5
6
abbrlink:
alg: crc32 # 算法,可选 crc16(默认) 或 crc32
rep: hex # 表示形式,可选 dec(默认) 或 hex
drafts: false # 是否为草稿生成 abbrlink
force: false # 是否强制重新生成
writeback: true # 是否写回到 Markdown 文件 front-matter

处理第一处报错

安装abbrlink插件后,出现文章图片404,我的文章图片引用方式是 Hexo 经典的「文章资源文件夹」用法(post_asset_folder: true 时自动生成同名文件夹)。

配置 hexo-abbrlink 后图片 404 的核心原因是:permalink 改为纯数字路径后,相对路径的「基准 URL 目录」变了,Hexo 原生的相对路径解析规则失效。

安装适配插件:hexo-asset-image

hexo-asset-image 是 Hexo 生态中专门解决「文章资源文件夹」图片路径问题的核心插件
执行以下安装命令

1
npm hexo-asset-image --save

配置 hexo-asset-image 插件

此插件无需额外配置,开箱即用,这里我就没有配置。

可选:自定义路径(进阶,按需配置)
_config.yml 中新增以下代码

1
2
3
4
5
hexo_asset_image:
enable: true # 开启插件(默认开启)
post_asset_folder: true # 关联文章资源文件夹(与全局配置一致)
# 可选:是否为图片添加 CDN 前缀(如需要 CDN 加速时)
# cdn: https://cdn.example.com/

处理第二处报错

由于我有篇文章的缩略图(cover:)采用了_posts文件夹下与md文件同名文件夹内的图片,所以也无法显示报404。

原本:cover: 图片.jpg
修改后:cover: abbrlink短链/图片.jpg

这样就解决了。