Hexo 小白变大神:搞懂这六个常用命令就够了!


大家好!今天我们来聊聊 Hexo,一个超级棒的静态博客框架。用它来搭建个人博客,不仅速度快,而且特别有范儿。不过,想要玩转 Hexo,你得先掌握它的一些基本“咒语”,也就是我们常说的命令行。

别担心,这些命令一点都不复杂。这篇文章我就带你把最核心、最常用的六个命令彻底搞懂,让你从小白快速上手,轻松管理你的博客!

1. hexo init - 你的第一个魔法:创建新家

万事开头难,但用 Hexo 开头一点都不难。hexo init 就是你施展的第一个魔法,它能帮你快速初始化一个全新的博客项目文件夹。

基础咒语:

hexo init [folder]

解析一下:

  • [folder] 是一个可选参数。如果你想在当前目录下直接创建博客,就直接输入 hexo init
  • 如果你想在一个指定的新文件夹(比如 my-awesome-blog)里创建,就这样写:

代码示例:

# 在一个名为 my-blog 的新文件夹中初始化你的博客
hexo init my-blog

# 进入这个新创建的目录,准备开始你的博客之旅
cd my-blog

执行完这个命令,Hexo 就会像变魔术一样,帮你把所有需要的配置文件、主题文件夹都准备好。你的博客“毛坯房”就建好了!

2. hexo new - 开始创作:写下你的第一篇文章

有了家,总得往里面添点东西吧?hexo new 命令就是你的“神笔马良”,专门用来创建新的博文。

基础咒语:

hexo new [layout] <title>

这个命令可以简写成 hexo n,是不是很方便?

解析一下:

  • [layout] 是可选的,它决定了你要创建什么类型的页面。默认是 post(文章),你也可以创建 page(独立页面,比如“关于我”)等等。这个默认值可以在你的 _config.yml 文件里修改。
  • <title> 是必填的,也就是你的文章标题。敲黑板: 如果你的标题里有空格,一定要用双引号把它包起来!

代码示例:

# 创建一篇标题为 "Hello World" 的文章
hexo new "Hello World"

# 创建一个 "About Me" 的独立页面
hexo new page "About Me"

运行命令后,Hexo 会在 source/_posts 文件夹里创建一个新的 Markdown 文件,文件名就是你的标题。打开它,就可以开始你的创作啦!

3. hexo generate - 见证奇迹:从 Markdown 到网页

你用 Markdown 写好了文章,但浏览器可不认识它。这时候就需要 hexo generate(可简写为 hexo g)出场了,它负责把你的所有 Markdown 文件和网站配置“翻译”成浏览器能看懂的静态 HTML 文件。

基础咒语:

hexo generate

解析一下:
这个命令会读取你的源文件,经过一系列处理,最终在你的项目根目录下生成一个 public 文件夹。这个文件夹里装的就是你整个网站的所有静态文件,可以直接部署到服务器上。

进阶玩法:

hexo generate -d
  • 加上 -d 选项,意思是在生成文件后,立刻执行部署操作。这和我们后面要讲的 hexo deploy 配合得天衣无缝,相当于 hexo g && hexo d 的组合技。

4. hexo server - 本地预览:看看效果怎么样

写完文章、生成好网页,总得先自己看看效果吧?总不能直接上线了才发现排版乱了。hexo server(可简写为 hexo s)命令就是你的本地预览神器。

基础咒语:

hexo server

解析一下:
运行这个命令后,Hexo 会在你的电脑上启动一个本地服务器。默认情况下,你只需要在浏览器里访问 http://localhost:4000 就能看到你的博客了。最酷的是,它还会实时监控你的文件改动,你这边一保存,那边浏览器自动刷新,超级方便!

友情提示: 第一次使用这个功能,需要先安装一个插件:

npm install hexo-server --save

自定义选项:

  • -p:如果你觉得 4000 端口被占用了,可以用这个选项换个端口,比如 hexo s -p 5000
  • -i:指定服务器的 IP 地址。
  • -s:静态模式,只提供 public 文件夹的内容,不会监控文件变动。

5. hexo deploy - 一键发布:让世界看到你的作品

当你在本地预览觉得一切完美后,就该把你的博客发布到互联网上,让所有人都能访问了。hexo deploy(可简写为 hexo d)就是实现这个目标的“传送门”。

基础咒语:

hexo deploy

解析一下:
这个命令会把你 public 文件夹里的所有内容推送到你在 _config.yml 文件里配置好的远程仓库(比如 GitHub Pages、Vercel 等)。

配置提醒: 在使用之前,你必须先配置好 _config.yml 文件里的 deploy 部分,并安装对应的部署插件,比如部署到 GitHub Pages 就需要 hexo-deployer-git

# _config.yml 文件示例
deploy:
  type: 'git'
  repo: https://github.com/your-username/your-repo.git
  branch: main

进阶玩法:

hexo deploy -g
  • 加上 -g 选项,表示在部署前,先执行一次生成操作。这和 hexo g -d 的效果完全一样,非常实用!

6. hexo clean - 大扫除:清除缓存保平安

有时候,你可能会遇到一些奇怪的问题,比如修改了配置却不生效,或者页面显示异常。这时候,别慌,试试 hexo clean 这个“清理咒语”。

基础咒语:

hexo clean

解析一下:
这个命令会清除 Hexo 生成的临时文件和缓存,主要是 db.jsonpublic 文件夹。当你的博客出现“玄学”问题时,先执行 hexo clean,再重新 hexo g 生成,往往能解决 90% 的烦恼。这是一个非常常用且重要的命令!


总结

好了,以上就是 Hexo 最核心的六个命令。我们来快速回顾一下一个标准的博客发布流程:

  1. hexo new "My New Post" - 新建一篇文章。
  2. (疯狂码字…)
  3. hexo server - 在本地边写边看效果。
  4. hexo clean - (可选) 如果遇到问题,先清理一下。
  5. hexo g -d - 生成并部署你的网站。

是不是很简单?把这几个命令多用几遍,你就能彻底掌握 Hexo 的精髓了。快去试试吧,祝你的博客之旅愉快!


  目录