hexo 博客搭建教程
hexo 博客搭建教程
注意:本篇文章针对把hexo搭建到github里,搭建至服务器请移步到其他教程
最近是打算把blog在github和mix space双边发,这样就算我服务器炸飞了,忘记续费了,博客都能正常运行(除非github倒闭)
1.环境准备-windows
1.1-nodejs 版本要大于16 点我跳转官网
1.2-git 点我下载
下载并安装完成后自行在cmd里通过以下指令确认安装
1 | node -v |
1 | npm -v |
1 | git --version |
若成功安装输出内容应为版本号
2.自行准备一个github账号
3.连接github
3.1-配置邮箱和用户名
在本地先创建一个文件夹 名字随意(hexo最好)
然后在空白的位置右键点击 Open Git Bash Here

在里面输入
1 | git config --global user.name "你的 GitHub 用户名" |
1 | git config --global user.email "你的 GitHub 邮箱" |
3.2-创建SSH密钥
1 | ssh-keygen -t rsa -C "你的 GitHub 邮箱" |
接下来一路回车即可
然后进入 C:\Users\ 用户名 \.ssh 目录(勾选显示 “隐藏的项目”)
复制id_rsa.pub里面的东西
3.3-在github里添加密钥
在github里打开setting后点击左边的ssh and keys 新建ssh key
标题随意,把id_rsa.pub里的东西复制到key后保存即可
3.3-验证连接
在git bash here里输入
1 | ssh -T git@github.com |
出现are you sure的时候输入yes确认

4.创建github仓库
在创建仓库时注意仓库名字必须为用户名.github.io
再勾选add a readme file
5.本地安装hexo
在文件夹内继续使用git输入一下命令
1 | npm install -g hexo-cli |
这样就代表安装成功了,安装过程不会有任何提示

接下来初始化hexo
1 | hexo init # 初始化hexo |
1 | npm install # 安装组件 |
6.上传hexo到github仓库
需要先在终端里输入以下指令
然后修改_config.yml 文件末尾的 Deployment 部分:

修改成下面的的样子(修改为你的用户名和仓库名)
1 | deploy: |
修改完成后保存运行以下指令
1 | hexo c |
这样就会将本地的东西传到github
然后我们需要在库设置(Repository Settings)中将默认分支设置为_config.yml 配置中的分支名称
然后在 pages 页面调整源分支
等一会儿后访问用户名.github.io不出意外就能看到网页了
- Titre: hexo 博客搭建教程
- Auteur: ZXEB
- Créé à : 2026-05-02 20:57:43
- Mis à jour à : 2026-05-02 20:59:32
- Lien: https://zxeb.github.io//posts/云服务器/93
- Licence: Cette œuvre est sous licence CC BY-NC-SA 4.0.