建站手记 Hexo 排错

页面出现乱码文字并解决

🔍 为什么是乱码?

用的是 Windows 自带的“记事本”编辑的 index.ejs。记事本默认会用“ANSI(中文系统下是 GBK)”格式保存文件。

但 Hexo 和浏览器默认用“UTF-8”格式去读。就像你用英语发音规则去读拼音,读出来肯定听不懂。

🛠️ 两步解决乱码:

第一步:在 HTML 里加上 UTF-8 声明(必须做)

打开 themes/my-theme/layout/index.ejs 文件,把 那一块改成这样:

<head>
<meta charset="utf-8"> <!-- 核心就加这一行 -->
<title><%= config.title %></title>
</head>

第二步:把文件重新保存为 UTF-8 格式(关键!)

加了那行代码后,不要直接点保存,否则还是乱码。你需要另存为:

在记事本里点击左上角的 “文件” -> “另存为”。

在底部找到 “编码” 下拉菜单。

把原来的 ANSI 改为 UTF-8 。

覆盖原来的 index.ejs 文件保存。

💡 强烈建议:为了以后不再受这个乱码的折磨,强烈建议你花 5 分钟下载一个免费工具 VS Code(code.visualstudio.com)。VS Code 默认就是 UTF-8,而且能高亮显示代码,你改完后以后基本不会再遇到编码问题了。

🚀 第三步:重新预览

去 Git Bash 里按 Ctrl + C 停掉之前的本地服务器,然后重新执行:

hexo clean
hexo s

再去 http://localhost:4000 看,乱码应该全消失,变成你写的中文了!


更新时间:2026年9月20日

墨安槿幻

墨安槿幻MOANJINHUAN

把现实改写成虚拟,把想留下的都留在这里。

关于我 →