GitHub+Hexo博客搭建

本文旨在为想要搭建一个属于自己博客的朋友们提供一定的支持和帮助，以下是一篇相当简洁明了的GitHub + Hexo博客搭建教程，包含准备工具、必要步骤及常用命令。

📝 GitHub + Hexo 博客搭建教程

一、环境准备

  1. 安装 Node.js (包含 npm，且需配置环境变量)
  2. 安装 Git
  3. cmd输入命令验证安装
1
2
3
4
# 验证安装
node -v
npm -v
git --versio

二、安装 Hexo

1.在电脑适合的地方如D盘文档下，鼠标右键菜单里，点击Open Git bash here

2.输入命令，创建博客文件夹，如newblog，初始化并安装Hexo主题框架

1
2
3
4
npm install -g hexo-cli
hexo init newblog  # 创建项目文件夹
cd newblog
npm install

三、配置 GitHub

  1. 创建仓库：<你的用户名>.github.io (必须全小写)
  2. 生成 SSH 密钥：
1
2
3
ssh-keygen -t ed25519 -C "your_email@example.com"
# 将公钥(~/.ssh/id_ed25519.pub)添加到 GitHub -> Settings -> SSH Keys

Plan B: 当然你也可选择https协议配置github,但需注意端口设置问题->修改git的网络设置->将其修改成与本机Ip和代理端口，弹出verification页面，登录即可。

1
2
git config --global http.proxy http://127.0.0.1:7890 
git config --global https.proxy http://127.0.0.1:7890

四、配置 Hexo

  1. 修改 _config.yml：
1
2
3
4
deploy:
  type: git
  repo: git@github.com:<你的用户名>/<你的用户名>.github.io.git
  branch: main
  1. 安装部署插件：
1
npm install hexo-deployer-git --save

这里遇到了一个问题，为了写这篇教程，我选择了另一个Github账户来逐步演示，当输入ssh -T git@github.com的时候显示的只有我的全局账户，也就是我第一个账户可以顺利deploy。那怎么一台电脑，不同的账户git呢，请选择如下图中配置即可。（P.s: 手动在你系统放.ssh文件的folder里创建config文件）

五、主题配置（以 Butterfly 为例）

1
2
npm install hexo-theme-butterfly

修改 _config.yml：

1
theme: butterfly

六、创建文章

1
2
hexo new "测试文章"
# 文章存储在 /source/_posts/

七、本地预览

1
2
3
4
hexo clean   # 清理缓存
hexo g       # 生成静态文件
hexo s       # 启动本地服务器
# 访问 http://localhost:4000

八、部署到 GitHub

1
2
hexo deploy  # 或简写 hexo d
# 访问 https://<你的用户名>.github.io

本人没自动化部署博客(2 years ago）前，喜好本地修改完成后一键三连

1
hexo c && hexo g && hexo d  # generate生成完直接推送的情况

九、后续维护

  • hexo命令：官方说明
  • 进阶设置：修改主题配置、添加插件等，见下续篇
  • 自定义域名：在对应仓库Repo -> Settings -> Pages -> Custom domain设置
  • 托管到vercel：登录Vercel -> New Project -> Import Git Repository，如“xxx.github.io”仓库，完成后还会分配给你一个域名

✅ 至此，完成！你的博客已上线。建议定期备份源码。