怎么使用 hexo 建博客

前言

个人博客哪家强，hexo 最在行。

笔者刚刚配置完成 hexo 环境，正好也是在 hexo 博客上的第一篇文章，那必须讲点有关 hexo 的知识了。

网上有很多关于 hexo 的教程，基本都有一个 bug，一旦 hexo g 的时候，就会报错，这其实是缺少 js 依赖的问题。如果你也遇到了这个 bug，那么恭喜你，看这篇文章就对了！先在博客的根目录的父文件夹执行 rm -r (你的博客根目录)（linux/macos）或 rmdir /s /q (你的博客根目录)（windows），然后开始和新手一样重新配置环境。

必备内容

1. GitHub
2. npm + nodejs
   • linux 推荐 apt,执行 sudo apt install nodejs npm 即可获取。
   • windows 出门左转去官网。
   • macos 同样出门左转去官网。
   • npm configsetregistry https://registry.npmmirror.com 设置 npm 镜像源。
3. git

配置环境

1. 打开终端，执行 npm install hexo-cli -g 安装 hexo。

2. 执行 hexo init (你的博客根目录) 初始化博客。

3. 执行 cd (你的博客根目录) 进入博客目录。

4. 至此，你可以 hexo g + hexo s 来测试博客是否正常运行。

   啊这…，你管这叫博客，什么垃圾网站！
   赶紧 hexo clean 掉。

5. 别急，我们需要配置主题，打开 https://hexo.io/themes/ 。

6. 选择一个你喜欢的主题，然后点开复制主题的仓库地址。

7. cd themes 进入主题目录。

8. 执行 git clone (你刚刚复制的仓库地址) (仓库地址去掉 hexo-theme-) 克隆主题。

9. 执行 cd (你刚刚复制的仓库地址) 进入主题目录。

10. 执行 npm install 安装主题依赖。

11. vim _config.yml 打开配置主题文件。（才你想要：有道翻译）

12. cd ..

13. vim _config.yml 打开配置博客文件。（注意theme:后填你的主题）

14. 尝试 hexo g + hexo s 来测试博客是否正常运行。

15. 如果正常运行，恭喜你，你已经成功配置好了博客环境。

16. 如果没有正常运行，先有道翻译一下报错信息，然后：

17. 如果显示缺少依赖，在执行 npm install (缺少的依赖) --save 安装依赖。

18. 如果发现缺少配置，配就完了。

19. 如果发现缺少图片，下载一个。

20. 每次修改完配置，都需要执行 hexo clean 清理缓存。

21. 如果还有问题

    • Q 问：https://chat.qwen.ai/c/guest
    • 文心：https://yiyan.baidu.com
    • 在问：https://zaiwen.xueban.org.cn
    • deepseek：https://chat.deepseek.com
    • C 知道：https://ai.csdn.net
    • 度娘：https://www.baidu.com

    我就不信你找不到答案了。

部署到 GitHub

1. vim _config.yml 打开配置博客文件。
2. 增加

1
2
3
4

deploy:
  type: 'git'
  repo: 'git@github.com:（你的 GitHub 用户名）/（你的 GitHub 用户名）.github.io.git'
  branch: 'main'

1. 执行 npm install hexo-deployer-git --save 安装部署插件。
2. 执行 hexo d 部署。
3. 享受你的博客吧！

写文章

1. 执行 hexo new (你的文章标题) 新建文章。
2. 执行 vim source/_posts/(你的文章标题).md 打开文章。
3. 编辑文章。
4. 执行 hexo clean + hexo g + hexo s 预览文章。

删除文章

直接删除 source/_posts/(你的文章标题).md 即可。

停止颓废，放弃博客（推荐）

1. 打开博客目录的父目录。
2. 执行 rm -r (你的博客根目录)（linux/macos）或 rmdir /s /q (你的博客根目录)（windows）。
3. 删除 GitHub 上的仓库。
4. 停止颓废，放弃博客。

完结撒花！