Hello World！我的第一篇 Hexo 博客与写作备忘录

欢迎来到我的全新博客！

这是我使用 Hexo 写下的第一篇文章。它不只是一个“Hello World”，也是我开始认真记录技术学习、生活观察和折腾过程的起点。刚接触 Hexo 的时候，我对它既兴奋又有点忐忑：兴奋的是终于可以拥有一个属于自己的独立博客，忐忑的是主题、配置、命令、部署这些词放在一起时，看起来并不轻松。

所以这篇文章我想站在初学者的角度，把热情留下来，也把真正有用的步骤整理下来。以后忘了命令、忘了流程，回来看这一篇就够了。

为什么我想搭一个 Hexo 博客

刚开始接触 Hexo 时，最打动我的不是“它有多高级”，而是它让我觉得写作这件事重新变得可控：文章就是 Markdown 文件，样式可以慢慢调整，页面可以本地预览，最后再生成静态网页发布出去。

对一个初学者来说，这种感觉很重要。它不像一些复杂系统那样一上来就要求你理解所有概念，而是允许你先跑起来，再一点点搞明白背后的原理。

我想用这个博客做三件事：

  1. 记录自己学习技术的过程，不只写结果，也写中间的疑惑和解决办法。
  2. 把常用命令、配置和踩坑经验沉淀下来，方便以后复查。
  3. 练习持续输出。哪怕一开始写得不成熟，也先认真写、慢慢改。

我知道自己还是新手，所以不会假装什么都懂。博客更像是一份公开的学习笔记：带着热情开始，带着耐心坚持，带着谦虚继续学。

Hexo 到底在做什么

用一句话理解 Hexo：它把我们写的 Markdown 文章和主题模板，生成可以直接部署的静态网页。

大致流程是：

1
2
3
4
5
6
7
Markdown 文章 + 站点配置 + 主题模板
          ↓
      hexo generate
          ↓
       public 静态网页
          ↓
      部署到 GitHub Pages / 服务器

这也是 Hexo 适合个人博客的原因：写作时关注 Markdown，发布时生成静态页面，不需要自己维护数据库。

初学者先认识这些目录

刚打开 Hexo 项目时，目录很多，容易不知道从哪里下手。先记住下面几个就够了：

1
2
3
4
5
6
7
8
9
_config.yml              站点总配置，比如标题、网址、语言、部署方式
_config.anzhiyu.yml      当前主题的配置文件，用来改菜单、样式、侧边栏等
source/_posts/           正式发布的文章都放在这里
source/_drafts/          草稿文章目录，默认不会出现在网站上
source/css/custom.css    自定义 CSS，适合放少量覆盖样式
scaffolds/               文章模板，新建文章时会用到
themes/                  主题文件目录
public/                  Hexo 生成的网站文件，通常不用手动改
package.json             项目依赖和 npm 脚本

我的经验是：新手不要急着改主题源码。优先改 _config.anzhiyu.yml 和 source/css/custom.css，这样更容易回退，也不容易把主题文件改乱。

最常用的 Hexo 命令

这些命令是我认为新手最应该先记住的。

新建文章

1
hexo new "文章标题"

它会在 source/_posts/ 下生成一篇 Markdown 文件。标题可以用中文，但文件名最好保持简洁，后续管理会更方便。

本地预览

1
hexo server

也可以简写为：

1
hexo s

默认预览地址通常是 http://localhost:4000。写文章和改样式时，建议一直开着本地预览，边改边看。

清理缓存

1
hexo clean

如果改了主题配置、样式或文章后页面没变化，先执行这个命令。很多“我明明改了为什么没生效”的问题，都可以从 hexo clean 开始排查。

生成静态网页

1
hexo generate

也可以简写为：

1
hexo g

它会把博客生成到 public/ 目录。

部署网站

1
hexo deploy

也可以简写为：

1
hexo d

这个命令需要先配置好部署信息，比如 GitHub Pages 的仓库地址。没有配置时不要急着执行，先把本地预览和生成流程跑通。

草稿箱是新手的好朋友

不是每一篇文章都要立刻发布。对于还在构思的内容，我更推荐先放进草稿。

1
hexo new draft "还在构思的文章"

预览草稿：

1
hexo server --draft

确认可以发布后：

1
hexo publish "还在构思的文章"

这样写作压力会小很多。先把想法放进去，慢慢补结构、补例子、补截图，最后再发布。

每篇文章开头的 Front Matter

Hexo 文章最上面这一段叫 Front Matter，用来描述文章信息。

1
2
3
4
5
6
7
---
title: 文章标题
date: 2026-03-10 22:56:00
tags: [Hexo, 博客, 教程]
categories: [建站日志]
description: 这里写一句文章摘要。
---

几个小提醒：

  1. 上下两行 --- 不要漏。
  2. 冒号后面建议留一个空格。
  3. tags 可以有多个，categories 通常少一点。
  4. description 写清楚一点，列表页和搜索结果里会更友好。

Markdown 写作备忘录

Hexo 的文章主要用 Markdown 写。下面这些语法已经够写大多数博客了。

标题

1
2
## 二级标题
### 三级标题

文章里建议从 ## 开始写小节，因为页面标题已经是一级标题了。

列表

1
2
3
4
5
6
1. 第一步
2. 第二步
3. 第三步

- 普通列表
- 另一个要点

引用

1
> 这里可以写一段提醒、感想或摘录。

代码块

1
2
3
4
5
```powershell
hexo clean
hexo generate
hexo server
```

代码块最好写上语言名称，比如 powershell、bash、yaml、css，这样高亮效果更好。

链接和图片

1
2
3
[Hexo 官网](https://hexo.io/)

![图片说明](/images/example.png)

如果图片放在 source/images/ 里，文章中通常可以用 /images/文件名 引用。

我的日常写作和发布流程

现在我比较喜欢用下面这套流程：

  1. 用 hexo new draft "标题" 新建草稿。
  2. 先写大纲，不急着追求完整。
  3. 用 hexo s --draft 本地预览排版。
  4. 补充命令、截图、踩坑原因和解决步骤。
  5. 用 hexo publish "标题" 发布草稿。
  6. 执行 hexo clean; hexo g; hexo s 做最终检查。
  7. 没问题后再执行 hexo d 部署。

如果采用“源码仓库 + 展示仓库”的双库方式，我还会在发布后提交源码：

1
2
3
4
git status
git add .
git commit -m "更新博客文章"
git push

这样既能保留博客源码，又能把生成后的页面部署出去。

我踩坑后总结的新手提醒

1. 配置文件缩进很重要

YAML 对缩进比较敏感。改 _config.yml 或主题配置时，不要随意混用空格和缩进层级。出错时先检查冒号、空格和缩进。

2. 页面没变化先清缓存

如果你确认文件改了，但浏览器里没变化，可以按这个顺序试：

1
2
3
hexo clean
hexo generate
hexo server

必要时再强制刷新浏览器缓存。

3. 主题配置优先于主题源码

主题源码能改，但不建议一开始就改。很多菜单、侧边栏、文章信息、颜色、注入 CSS 的功能，都可以在主题配置里完成。

4. 部署前一定本地预览

不要写完文章就直接部署。至少先跑一次：

1
2
hexo clean
hexo generate

如果生成没报错，再打开本地预览检查文章标题、分类、标签、代码块和图片。

5. 不要害怕重新整理

刚开始写博客时，分类和标签很可能会变。没关系，先保持简单，等文章多了再统一整理。比起一开始设计完美结构，更重要的是先持续写下去。

一键常用命令备忘

日常写完文章后，我最常用的是：

1
hexo clean; hexo g; hexo s

确认本地预览没问题后，再部署：

1
hexo clean; hexo g; hexo d

如果改了源码，也别忘了提交：

1
2
3
git add .
git commit -m "更新博客"
git push

写在最后

这篇第一篇文章，对我来说更像一个起点。它记录了我刚接触 Hexo 时的热情，也提醒我保持谦虚：不会的地方就查资料、做实验、写下来；踩过的坑就复盘清楚，下一次少走弯路。

博客搭起来只是第一步，真正重要的是持续学习、持续记录、持续改进。希望以后回头看这篇文章时，我还能记得现在这种刚开始出发的认真劲，也能看到自己一点点变得更熟练。