当前位置：首页 > news >正文

个人博客搭建记录【hexo】

news 2026/6/11 7:45:21

安装hexo

部署环境

Node.js
Git

Node.js 部署，建议版本大于 12.0

　　Node.js 安装中步骤中需要注意其中两处：

Add to PATH 选上，使其集成到系统环境中：

此处勾选会安装各种编程环境和软件，这对于安装hexo是不必要的：

Git 部署

　　所有安装步骤默认即可，若不需要右键菜单，取消如下勾选：

　　‍

部署hexo

　　打开gitbash，将目录切换至预备安装hexo的文件夹。

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

如果git安装时勾选了右键菜单，则可以直接在相应文件夹中右键启动gitbash。

　　至此hexo核心程序完成部署。

Github发布个人博客

安装 hexo-deployer-git.

npm install hexo-deployer-git --save

在hexo部署文件夹中打开 _config.yml添加以下配置（如果存在请替换）：

deploy:type: gitrepo: git@github.com:<username>/<project>.git# example, hgit@github.com:hexojs/hexojs.github.io.gitbranch: main # 此处与github项目分支名相同

可以直接从Github项目主页直接复制需要的repo：

hexo文件夹处使用gitbash，执行以下命令(替换自己的用户名和邮箱）生成本地远程连接github项目的密钥：
```
git config --global user.name "<username>"
git config --global user.email "<user@mail>"ssh-keygen -t rsa -C "<user@mail>"
```
部署项目（Github Page）及密钥
1. 密钥文件生成后，使用记事本打开并复制id_rsa.pub内容
2. 打开github，新建<username> .github.io项目
3. 进入项目settings，打开如下页面：
hexo文件夹中打开gitbash，执行命令
```
hexo g # 将 _post 文件夹渲染成静态html
hexo d # 发布至GitHub
```
若是第一次执行，按提示输入yes.
进入username.github.io查看博客是否部署完成

hexo 相关重要信息

hexo 常用命令

hexo g                 #完整命令为hexo generate,用于生成静态文件
hexo s                 #完整命令为hexo server,用于启动服务器，主要用来本地预览
hexo d                 #完整命令为hexo deploy,用于将本地文件发布到github等git仓库上
hexo n “my article”    #完整命令为hexo new,用于新建一篇名为“my article”的文章,文件格式为md
hexo clean             #清除已渲染html，将删除publish文件夹hexo d -g              #发布文章二合一命令

hexo 常见前置信息

　　hexo 前置信息(front-matter)是放在文章前面，指定标签，分类，主题等文件变量信息，使用git命令生成文章文件会按命令内容生成前置信息，或者也可以自己编辑，格式如下：

---
layout: 页面布局（配合主题文档使用）
title: 文章名称
date: 文章日期
comments: 文章是否开启评论
photos: 文章封面图（仅部分主题支持）
tags: - 文章标签一- 文章标签二
categories: 文章分类
description: 文章描述，即要在首页显示的摘要（仅部分主题支持）
---