Hexo博客搭建指南

快速搭建Hexo博客的指南

Hexo 是一个快速、简单且功能强大的博客框架，基于 Node.js，非常适合想要快速创建个人博客的开发者。本指南将详细介绍如何搭建 Hexo 博客并将其部署到 GitHub Pages，附带截图以便更清晰地理解每个步骤。让我们开始吧！

前提条件

在开始之前，请确保已安装以下工具：

• Node.js（版本 12 或更高）：从 nodejs.org 下载。
• Git：从 git-scm.com 下载。
• GitHub 账户：在 github.com 注册。

步骤 1：安装 Hexo CLI

1. 打开终端（Windows 上为命令提示符或 PowerShell，macOS/Linux 上为终端）。

2. 全局安装 Hexo 命令行工具：

   npm install -g hexo-cli

3. 验证安装是否成功：

   hexo --version

步骤 2：创建新的 Hexo 项目

1. 创建一个新目录用于存放博客，并进入该目录：

   mkdir my-hexo-blog
   cd my-hexo-blog

2. 初始化一个新的 Hexo 项目：

   hexo init

3. 安装依赖项：

   npm install

4. 启动本地服务器以预览博客：

   hexo server

5. 打开浏览器，访问 http://localhost:4000，即可看到默认的 Hexo 博客页面。

步骤 3：配置博客

1. 使用文本编辑器打开项目根目录下的 _config.yml 文件。

2. 修改基本设置，例如：

   title: 我的精彩博客
   subtitle: 欢迎体验我的世界
   description: 一个关于科技与生活的博客
   author: 你的名字
   language: zh-CN
   timezone: Asia/Shanghai

3. 保存文件。

步骤 4：创建新文章

1. 创建一篇新博客文章：

   hexo new "我的第一篇文章"

2. 这会在 source/_posts/我的第一篇文章.md 中生成一个文件。打开文件并使用 Markdown 编辑内容。

3. 重新启动服务器以预览文章：

   hexo server

步骤 5：部署到 GitHub Pages

1. 创建 GitHub 仓库：

   • 登录 GitHub，创建一个名为 username.github.io 的新仓库（将 username 替换为你的 GitHub 用户名）。
   • 确保仓库为公开。

2. 安装 Hexo 部署插件：

   • 安装 Git 部署插件：

     npm install hexo-deployer-git --save

3. 配置部署：

   • 在 _config.yml 文件中，添加以下 deploy 配置：

     deploy:
       type: git
       repo: https://github.com/username/username.github.io.git
       branch: main

   • 将 username 替换为你的 GitHub 用户名。

4. 生成并部署：

   • 生成静态文件：

     hexo generate

   • 部署到 GitHub Pages：

     hexo deploy

   • 如果提示需要认证，请输入你的 GitHub 账户凭据。

   

5. 访问 https://username.github.io，即可查看你的在线博客。

步骤 6：自定义博客（可选）

1. 更换主题：

   • 在 hexo.io/themes 浏览主题。

   • 下载一个主题（例如 NexT）并解压到 themes/ 文件夹。

   • 更新 _config.yml：

     theme: next

   • 重新生成并部署：

     hexo generate
     hexo deploy

2. 添加插件：

   • 安装 SEO 插件，如 hexo-generator-sitemap：

     npm install hexo-generator-sitemap --save

   • 根据需要在 _config.yml 中配置插件。

常见问题排查

• GitHub Pages 显示 404 错误：确保仓库名为 username.github.io，并且 _config.yml 中的 deploy 设置正确。
• 图片无法显示：将图片放置在 source/images/ 目录下，并在 Markdown 中使用 /images/图片名 引用。
• 部署失败：检查 GitHub 凭据是否正确，并确保已安装 hexo-deployer-git。

总结

通过以上步骤，你已经成功搭建并部署了一个 Hexo 博客！Hexo 的灵活性和丰富的主题生态系统让你的博客可以轻松个性化。现在，尽情创作并与世界分享你的故事吧！

遇到问题？欢迎在评论区留言！