【基于hexo与gitee-pages搭建个人博客】

一、环境准备（5分钟）

1. 安装Node.js

• 访问Node.js官网
• 下载 LTS版本（长期支持版）

• 参考Nodejs安装

• 双击安装，一路点击“Next”即可

• 验证安装（命令提示符中输入）：

node -v  # 显示版本号（如v18.12.1）
npm -v   # 显示npm版本号

2. 安装Git

• 访问Git官网

• 下载适合你系统的版本

• 安装时勾选“Add to PATH”（将git加入环境变量）

• 验证安装：

git --version  # 显示版本号（如git version 2.37.1）

---

二、Hexo本地安装（3分钟）

win+r输入cmd打开命令行

0.npm切换国内镜像源

npm config set registry https://registry.npmmirror.com # 切换淘宝镜像源

1. 安装Hexo命令行工具

npm install -g hexo-cli

2. 创建博客项目

cd xxx # 进入你想要创建博客的目录
hexo init myblog  # 创建名为myblog的博客
cd myblog         # 进入项目目录
npm install       # 安装依赖

3. 本地启动博客

hexo clean   # 清理缓存
hexo g       # 生成静态文件（g=generate）
hexo s       # 启动服务（s=server）

访问 http://localhost:4000 即可看到默认博客！

---

三、Gitee仓库准备

1. 注册Gitee账号

• 访问Gitee官网
• 点击注册，填写邮箱/手机号（建议使用英文邮箱，建议不要使用qq号码邮箱）

2. 创建特殊命名的仓库

• 仓库名必须为：你的用户名
  （例如用户名为 lyriv，仓库名应为 lyriv）
• 仓库权限选择 公开
• 设置模板：勾选Redame文件

3. 配置SSH公钥（免密推送）

# 1. 生成密钥（一路回车）
ssh-keygen -t rsa -C "your_email@example.com" #建议使用英文邮箱，建议不要使用qq号码邮箱，填写你刚刚注册gitee账号的邮箱

# 2. 查看公钥内容
cat ~/.ssh/id_rsa.pub 

id_rsa.pub 文件一般在这个路径下

4. 将公匙配置到gitee

• 用记事本打开id_rsa.pub文件

• 复制到gitee中的公匙配置页

• 添加公匙

四、部署到Gitee Pages

1. 修改Hexo部署配置

打开项目根目录的 _config.yml 文件，找到 deploy 部分：

• 注意缩进

deploy:
  type: git
  repo: git@gitee.com:你的用户名.gitee.io.git
  branch: master

2. 安装部署插件

npm install hexo-deployer-git --save

3. 一键部署到Gitee

bash

hexo clean
hexo g
hexo d   # d=deploy

首次部署需输入Gitee账号密码

4. 开启Gitee Pages服务

1. 进入Gitee仓库 -> 点击 “服务”
2. 选择 Gitee Pages
3. 部署分支：master
4. 部署目录：/（根目录）
5. 点击 “启动”

等待1分钟后，访问 https://你的用户名.gitee.io 即可看到你的博客！