技术

我的第一篇博客

欢迎来到我的Hexo博客！

今天，我成功使用Hexo搭建了我的个人博客。这是一个非常棒的静态博客生成器，让我来分享一下这个过程。

为什么选择Hexo？

  • 快速：基于Node.js，生成速度极快
  • 简洁：配置简单，易于上手
  • 强大：支持丰富的插件和主题
  • 免费：可以部署在GitHub Pages上，完全免费

搭建过程

  1. 安装Node.js和npm
  2. 安装Hexo CLI：npm install -g hexo-cli
  3. 初始化项目：hexo init my-blog
  4. 安装依赖：npm install
  5. 启动服务器：hexo server

接下来的计划

  • 选择一个漂亮的主题
  • 配置GitHub Pages自动部署
  • 添加评论系统
  • 优化SEO设置
  • 写更多技术文章

技术栈

  • 框架：Hexo
  • 语言：Markdown
  • 主题：Landscape（默认）
  • 部署：GitHub Pages

希望这个博客能成为我记录技术成长的地方！

“技术的道路很长，但每一步都值得记录。”

技术

如何更新Hexo博客

如何更新Hexo博客 - 完整指南

博客更新包括内容更新、样式更新、功能更新等多个方面。本文将详细介绍每个步骤。

📑 内容更新

1. 添加新文章

1
2
3
4
5
6
7
8
# 创建新文章
hexo new post "文章标题"

# 创建草稿
hexo new draft "草稿标题"

# 创建页面
hexo new page "关于我"

2. 文章格式

每篇文章使用Markdown格式，包含YAML前置元数据：

1
2
3
4
5
6
7
8
9
---
title: 文章标题
date: 2025-08-22 13:31:05
tags: [标签1, 标签2]
categories: 分类
description: 文章描述
---

文章内容...

🎨 样式更新

1. 更换主题

步骤：

  1. 在 hexo.io/themes 选择主题
  2. 下载主题到 themes/ 目录
  3. 修改 _config.yml 中的 theme: 配置

示例：

1
2
3
4
5
# 克隆NexT主题
git clone https://github.com/next-theme/hexo-theme-next themes/next

# 修改配置文件中的主题设置
theme: next

2. 自定义样式

  • 编辑 themes/主题名称/source/css/ 中的CSS文件
  • 在 source/css/ 中添加自定义样式

⚙️ 配置更新

1. 网站基本信息

编辑 _config.yml：

1
2
3
4
5
6
7
8
9
10
11
# 网站信息
title: 我的博客名称
subtitle: 博客副标题
description: 博客描述
keywords: 关键词1, 关键词2
author: 作者名称
language: zh-CN
timezone: Asia/Shanghai

# URL配置
url: https://yourusername.github.io

2. 插件配置

常用插件安装：

1
2
3
4
5
6
7
8
9
10
11
# 搜索插件
npm install hexo-generator-searchdb --save

# 站点地图
npm install hexo-generator-sitemap --save

# 百度站点地图
npm install hexo-generator-baidu-sitemap --save

# 阅读统计
npm install hexo-symbols-count-time --save

🚀 部署更新

1. 本地测试

1
2
3
4
5
6
7
8
# 清理缓存
hexo clean

# 生成静态文件
hexo generate

# 启动本地服务器
hexo server

2. 部署到GitHub Pages

1
2
3
4
5
# 一键部署
hexo deploy

# 或者使用npm脚本
npm run deploy

📋 更新检查清单

每次更新前：

  • 备份重要内容
  • 检查配置文件语法
  • 确认依赖版本兼容性

更新流程：

  1. 内容更新：添加/编辑文章
  2. 本地测试：确认显示正常
  3. 生成静态文件：hexo generate
  4. 部署：hexo deploy
  5. 验证：访问线上地址确认更新

常见更新场景：

场景1：添加新文章

1
2
3
4
hexo new post "新文章标题"
# 编辑文章内容
hexo generate
hexo deploy

场景2：修改主题配置

1
2
3
4
# 编辑主题配置文件
hexo clean
hexo generate
hexo deploy

场景3：更新Hexo版本

1
2
3
4
npm update hexo
hexo clean
hexo generate
hexo deploy

🔧 故障排除

问题1：样式不生效

  • 运行 hexo clean 清理缓存
  • 检查浏览器缓存
  • 确认文件路径正确

问题2：部署失败

  • 检查GitHub Token权限
  • 确认仓库地址正确
  • 查看错误日志

问题3：中文乱码

  • 确认文件编码为UTF-8
  • 检查 _config.yml 中的语言设置

📊 定期维护建议

  1. 每周：检查并回复评论
  2. 每月：更新依赖包，检查链接有效性
  3. 每季度：备份整个博客项目
  4. 每年：评估主题和插件的更新

通过以上步骤，你可以轻松维护和更新你的Hexo博客！