建站手记 Hexo 主题

删除或换掉 reimu 主题

🗑️第一步:如何卸载或换掉现在的 Reimu 主题?

千万不要直接去 themes 文件夹里把 reimu 文件夹删掉,如果 _config.yml 里还写着 theme: reimu,Hexo 启动会直接报错。

安全做法如下:

1. 先切换回默认主题:

打开根目录 _config.yml,把 theme: reimu 改成:

theme: landscape

landscape 是 Hexo 自带的默认主题,一直都在你的 themes 文件夹里)。

2. 清理缓存:

在 Git Bash 里运行 hexo clean。

3. 测试是否成功:

运行 hexo s,打开 http://localhost:4000 , 如果看到默认的蓝白主题,说明切换成功了。

4. 删除 Reimu(可选):

确认成功切换后,你可以去 themes 文件夹里,把 reimu 文件夹整个删掉。
(另外,你之前建在根目录的 _config.reimu.yml 也可以一并删掉)。

🎨 第二步:如何从零开始做一个自己的主题?

做主题,其实就是把你设计的静态 HTML 网页,变成 Hexo 能读懂的“模板”。跟着我按以下步骤做:

1. 创建主题的“空壳”

✅ 正确的“从零开始做主题”方法
第一步:手动创建主题文件夹
不需要敲任何命令,直接去你的电脑文件夹里,找到博客根目录下的 themes 文件夹。在里面,新建一个文件夹,名字就是你想要的主题名字,比如 my-theme。

第二步:让 Hexo 认识你的新主题
打开博客根目录的 _config.yml 文件,把 theme: 后面的名字,改成你刚创建的文件夹名字:theme: my-theme。

第三步:创建主题必备的“骨架”文件
进入 themes/my-theme/ 文件夹,在里面新建以下内容:

  • 新建一个文件夹 layout

  • 新建一个文件夹 source

  • 新建一个文件 _config.yml(这个文件可以先空着)

2. 认识三个核心文件

去 themes/my-theme 文件夹里,你会看到这些核心目录:

  • _config.yml:你的主题的配置项(比如是否开启某功能)。

  • layout/:这里放的是模板文件(.ejs 后缀)。

  • source/:这里放你的 CSS、JS、图片。

3. 🎨 下一步:怎么开始写你的第一个页面?

刚才创建的 layout 文件夹就是用来放模板文件的地方。你需要用记事本或 VS Code 在里面新建一个文件,命名为 index.ejs,然后把下面这段代码复制进去:

<!DOCTYPE html>
<html>
<head>
<title><%= config.title %></title>
</head>
<body>
<h1>这是我亲手做的主题!</h1>
<p>网站标题是:<%= config.title %></p>
<% page.posts.each(function(post){ %>
<div>
<h2><a href="<%- url_for(post.path) %>"><%= post.title %></a></h2>
</div>
<% }); %>
</body>
</html>

4. 开启你的主题

去根目录 _config.yml,把 theme: landscape 改成 theme: my-theme。
在 Git Bash 里执行:

hexo clean
hexo s

打开 localhost:4000,你就能看到你刚亲手搭出来的主题(虽然可能非常简陋,但那是你写的!)。


更新时间:2026年9月19日

墨安槿幻

墨安槿幻MOANJINHUAN

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

关于我 →