Hexo+GitubPage 文章发布教程

本指南介绍如何使用 Hexo 在本地编写文章，并部署到 GitHub Pages。假设已完成以下前置步骤：

• 安装 Node.js 和 Git
• 初始化 Hexo 项目（hexo init myblog && cd myblog）
• 配置 GitHub Pages 仓库（仓库名 用户名.github.io）
• 设置 Hexo 的 _config.yml 部署信息（参考上一步骤）

一、编写新文章

1. 创建文章模板 在项目根目录运行：

hexo new "文章标题"  # 示例：hexo new "Hexo部署指南"

• 文件将生成在 source/_posts/文章标题.md
• 文件头包含 Front-matter（元数据配置区域）

1. 编辑文章内容 用 Markdown 编辑器（如 VS Code）打开生成的 .md 文件：

---
   title: 文章标题
   date: 2024-01-01 00:00:00  # 自动生成，可修改
   tags: 
     - 标签1
     - 标签2
   categories: 分类名称  # 如 "教程"
   cover: /images/cover.jpg  # 封面图路径（可选）
 ---
   
   <!-- 下方编写正文（Markdown语法） -->
   这里是文章内容，支持：
   - **粗体**、*斜体*
   - [链接](https://example.com)
   - ```代码块```
   - ![](/images/demo.png) 图片

二、本地预览与调试

1. 启动本地服务器：

hexo server  # 或简写 hexo s

1. 访问 http://localhost:4000 实时预览效果。
2. 修改内容后保存，页面自动刷新（如未刷新，手动重启服务）。

三、生成静态文件

hexo generate  # 或简写 hexo g

• 生成的网页文件保存在 /public 目录（勿手动修改此目录）。

四、部署到 GitHub Pages

1. 安装部署插件（未安装时执行）：

npm install hexo-deployer-git --save

1. 一键部署：

hexo deploy  # 或简写 hexo d

• 文件将推送至 GitHub 仓库的 main 分支（或其他配置分支）。

1. 访问在线博客： 打开 https://用户名.github.io（首次部署需等待 1-2 分钟生效）。

五、更新或删除文章

1. 更新文章：

• 直接修改 source/_posts/文章标题.md 文件，重新执行 hexo g -d（生成+部署）。

2. 删除文章：

• 删除对应的 .md 文件，执行 hexo clean && hexo g -d（清理缓存后重新部署）。

六、常用命令速查

命令	作用
hexo new "标题"	新建文章
hexo server	本地预览
hexo generate	生成静态文件
hexo deploy	部署到 GitHub
hexo clean	清理缓存和旧文件
hexo g -d	生成并立即部署（组合命令）

七、故障排查

1. 部署失败：

• 检查 _config.yml 的 deploy 配置是否正确：

deploy:
  type: git
  repo: https://github.com/用户名/用户名.github.io.git
  branch: master

• 确保已安装部署插件（hexo-deployer-git）。

1. 页面样式异常：

• 执行 hexo clean 清除缓存后再生成文件。

2. 图片不显示：

• 将图片放入 source/images/，使用路径![](/images/文件名.png)。

提示：所有操作在 Hexo 项目根目录的终端中执行。