于 Hexo + GitHub Pages 的搭建个人博客网站的详细教程

以下是快速搭建个人博客网站的详细教程，基于 Hexo + GitHub Pages 的免费方案，无需服务器和域名即可快速上线，适合零基础用户。

一、准备工作

1. 注册GitHub账号
   访问 GitHub官网，注册账号。后续将通过GitHub Pages托管博客。

2. 安装Git

   • Windows/Mac用户：从Git官网下载安装包，按提示安装。
   • 安装完成后，终端输入 git --version 验证是否成功。

3. 安装Node.js

   • 从Node.js官网下载LTS版本安装包。安装完成后，终端输入 node -v 和 npm -v 检查版本。

二、安装并初始化Hexo

Hexo是一个基于Node.js的静态博客框架，支持Markdown写作，生成速度快。

1. 安装Hexo
   终端执行以下命令：

   npm install -g hexo-cli
   

   • 若因网络问题安装失败，可切换为国内镜像：

     npm config set registry https://registry.npm.taobao.org
     

   • 安装成功后，输入 hexo -v 验证。

2. 初始化博客项目

   hexo init myblog  # 创建名为myblog的文件夹
   cd myblog
   npm install
   

三、配置博客基本信息

1. 修改站点配置
   打开 myblog/_config.yml 文件，修改以下字段：

   title: 我的博客         # 博客标题
   subtitle: 记录技术点滴    # 副标题
   author: 你的名字         # 作者名
   language: zh-CN        # 语言
   timezone: Asia/Shanghai # 时区
   

2. 更换主题（可选）

   • 从Hexo主题库选择主题（如Butterfly、Next）。
   • 终端执行 git clone 主题仓库地址 themes/主题名，然后在 _config.yml 中修改 theme: 主题名。

四、创建并发布文章

1. 生成新文章

   hexo new "我的第一篇博客"
   

   • 文章Markdown文件位于 source/_posts 目录下，可编辑内容并添加Front-matter（如分类、标签）。

2. 本地预览

   hexo clean && hexo generate  # 生成静态文件
   hexo server                  # 启动本地服务
   

   • 访问 http://localhost:4000 查看效果。

五、部署到GitHub Pages

1. 创建GitHub仓库

   • 仓库名必须为 用户名.github.io（如 AI-Green.github.io），选择Public可见性。

2. 配置Hexo部署插件

   • 安装部署插件：

     npm install hexo-deployer-git --save
     

   • 修改 _config.yml 文件末尾的部署配置：

     deploy:
       type: git
       repo: git@github.com:用户名/用户名.github.io.git  # 替换为你的仓库地址
       branch: main  # 分支名可能是main或master
     

3. 部署到GitHub

   hexo clean && hexo generate && hexo deploy
   

   • 完成后访问 https://用户名.github.io 即可看到在线博客。

六、进阶优化

1. 绑定自定义域名

   • 在域名服务商（如阿里云）添加CNAME记录指向 用户名.github.io。
   • 在博客的 source 目录下创建 CNAME 文件，写入域名（如 blog.example.com），重新部署。

2. 加速国内访问

   • 同步部署到Gitee或Coding Pages，利用国内CDN加速。

3. SEO优化

   • 在 _config.yml 中设置关键词（keywords）。
   • 安装 hexo-generator-sitemap 插件生成站点地图。

常见问题

• 部署失败：检查SSH密钥是否配置（通过 ssh -T git@github.com 验证）。
• 页面样式异常：执行 hexo clean 清除缓存后重新生成。
• 文章不显示：确认Markdown文件的Front-matter格式正确。

通过以上步骤，20分钟内即可完成个人博客的搭建。如需更个性化功能（如评论系统、数据分析），可参考Hexo插件库扩展。