学习用Hexo写博客

1. 安装Node.js#

• 操作：
  1. 打开Node.js官网，点击对应Windows版本的安装包（如“Windows Installer (.msi) 64-bit”）；
  2. 双击安装包，勾选“Accept the terms…”，点击“Next”；
  3. 安装路径保持默认（或自定义，需记住路径），点击“Next”；
  4. 勾选“Add to PATH”（自动配置环境变量），点击“Next”→“Install”→“Finish”。
• 验证： 右键桌面→选择“Git Bash Here”打开终端，输入node -v，我安装的是v.24.5.0版本。

2. 安装Git#

• 操作：

  1. 打开Git官网，点击“Download for Windows”；
  2. 双击安装包，依次点击“Next”；
  3. 安装路径保持默认，点击“Next”；
  4. 组件选择默认（需包含“Git Bash Here”），点击“Next”；
  5. 开始菜单文件夹保持默认，点击“Next”；
  6. 选择“Use Visual Studio Code as Git’s default editor”（或默认编辑器），点击“Next”；
  7. 选择“Let Git decide”（换行符处理），点击“Next”→“Next”→“Next”；
  8. 选择“Use Windows’ default console window”，点击“Next”→“Install”→“Finish”。

• 验证： 右键桌面→选择“Git Bash Here”，输入git -v，若显示版本号（如git version 2.43.0.windows.1）则成功。

• 必做配置： 在Git Bash中输入以下命令，绑定Git与GitHub的身份：

  1
  git config --global user.name "你的GitHub用户名"  # 如"lycaonide"
  2
  git config --global user.email "你的GitHub注册邮箱"

3. 注册并登录GitHub#

• 操作：
  1. 打开GitHub官网，点击“Sign up”；
  2. 输入邮箱→创建密码→输入用户名（需记住，后续仓库名要用）→完成验证；
  3. 登录后，进入GitHub主页。

1. 创建本地Hexo项目#

• 操作：

  1. 右键桌面→选择“Git Bash Here”；
  2. 输入命令安装Hexo脚手架（全局工具）：

     1
     npm install -g hexo-cli

     （等待终端显示“added xx packages in xx s”即安装完成）
  3. 输入命令在桌面创建Hexo项目（项目名自定义，这里用my-hexo-blog）：

     1
     hexo init my-hexo-blog

     （等待终端显示“Start blogging with Hexo!”即初始化完成）
  4. 进入项目目录并安装依赖：

     1
     cd my-hexo-blog  # 进入项目文件夹
     2
     npm install      # 安装项目依赖

2. 本地预览博客（确保本地能正常运行）#

• 操作： 在Git Bash的my-hexo-blog目录下，输入：

  1
  hexo server  # 可简写为 hexo s

• 反馈： 终端显示“Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.”。
• 验证： 打开浏览器，输入http://localhost:4000，若显示Hexo默认博客页面（白色背景、“Hello World”文章）则本地运行成功。
• 关闭预览： 在Git Bash中按Ctrl+C终止服务。

1. 打开Hexo的配置文件#

• 操作：
  1. 打开桌面的my-hexo-blog文件夹→找到_config.yml文件。
  2. 右键点击“用记事本编辑”。

2. 修改部署配置#

• 操作： 滚动到_config.yml文件的末尾，找到deploy段落（默认可能是注释状态），修改为：

  1
  deploy:
  2
    type: git
  3
    repo: git@github.com:lycaonide/lycaonide.github.io.git  # 替换为你的仓库SSH地址
  4
    branch: main

• 关键说明：

  • repo地址获取：进入GitHub仓库页面→点击“Code”按钮→选择“SSH”→复制地址（以git@github.com:开头）；
  • 缩进要求：type、repo、branch必须与deploy保持2个空格的缩进（YAML语法不支持Tab，必须用空格）。

1. 新建博客文章#

• 操作： 打开Git Bash，进入Hexo项目目录（如桌面的my-hexo-blog）：

  1
  cd ~/Desktop/my-hexo-blog  # 替换为你的Hexo项目路径

  输入命令新建文章，替换为你的博客标题：

  1
  hexo new "我的第一篇Hexo博客"

• 反馈： 终端显示“INFO Created: source/_posts/我的第一篇Hexo博客.md”，表示文章文件已生成。

• 文件位置： 文章存放在Hexo项目的source/_posts/目录下，文件名是我的第一篇Hexo博客.md。

2. 编辑博客内容#

• 操作

​ 打开文章文件：用任意Markdown编辑器打开source/_posts/我的第一篇Hexo博客.md文件。

​ 配置文章信息：文件开头的“Front-matter”是Hexo识别文章属性的区域（必须保留），示例说明：

1
---
2
title: 我的第一篇Hexo博客  # 博客标题（会显示在页面顶部）
3
date: 2026-01-25 10:00:00  # 发布日期（自动生成，可修改）
4
tags: [Hexo, 博客]  # 文章标签（多个标签用数组包裹）
5
categories: 技术笔记  # 文章分类（可自定义分类名）
6
---

​ 说明：格式必须严格（冒号后加空格），否则Hexo会解析失败。

​ 编写正文内容（Markdown语法）：在---下方编写博客正文，示例：

1
# 一级标题
2
这是我的第一篇Hexo博客，终于成功部署啦！
3

4
## 二级标题：Hexo的优点
5
- 轻量化，部署简单
6
- 支持Markdown编辑，写作体验好
7
- 可自定义主题（后续会分享主题更换方法）
8

9
### 三级标题：插入图片
10
把图片放到Hexo项目的`source/images/`目录下，引用方式：
11
![示例图片](/images/我的图片.jpg)  # 路径从public目录根开始
12

13
### 三级标题：添加链接
14
推荐Hexo官网：[Hexo官方文档](https://hexo.io/zh-cn/docs/)

3. 本地预览博客效果#

• 操作： 在Git Bash的Hexo项目目录下，输入命令启动本地服务：

  1
  hexo clean  # 先清理旧缓存（可选，但建议执行）
  2
  hexo s      # 启动本地预览

• 验证： 打开浏览器访问http://localhost:4000，在“文章”列表中找到《我的第一篇Hexo博客》，点击进入查看格式、图片、链接是否正常显示。

• 关闭预览： 在Git Bash中按Ctrl+C终止服务。

4. 发布新博客到线上#

• 操作： 在Git Bash的Hexo项目目录下，依次执行命令（更新线上博客）：

  1
  hexo clean  # 清理本地缓存
  2
  hexo g      # 重新生成包含新文章的静态文件
  3
  hexo d      # 部署到GitHub仓库

• 反馈： 终端显示“INFO Deploy done: git”即部署完成。

五、验证线上效果#

等待1-3分钟后，打开浏览器访问https://lycaonide.github.io，刷新页面后即可看到新发布的《我的第一篇Hexo博客》出现在文章列表中。

补充注意事项#

1. 图片存放：博客中用到的图片，需放到Hexo项目的source/images/目录下，引用路径写/images/图片名.jpg（Hexo会自动将source/images映射到网站根目录）；
2. 修改已发布文章：直接编辑source/_posts/下对应的MD文件，重复“本地预览→hexo clean→hexo g→hexo d”步骤即可更新线上内容；
3. 删除文章：删除source/_posts/下对应的MD文件，再执行部署命令，线上文章会同步删除。