前言

Hexo 是一个快速、简洁且高效的博客框架，使用 Markdown 解析文章，可以在几秒内生成静态网页。本教程将指导您从零开始搭建一个 Hexo 博客网站，并部署到互联网上。

在开始搭建 Hexo 博客之前，我们先了解一下基本流程和准备工作。完整的搭建过程包括：环境准备、Hexo安装、主题配置和网站部署等步骤。

必要的工具和链接

  • Node.js：运行 Hexo 的必要环境，请安装最新版本。
  • Git：用于版本控制和管理代码。
  • 淘宝 NPM 镜像源：用于加速 npm 包的安装。
  • Hexo 官方网站：可以查找更多主题和插件。
  • GitHub：用来存储博客代码，需要一个 GitHub 账号。
  • Visual Studio Code：推荐使用的编辑器，便于代码管理（可选）。

检查环境

安装完 Node.js 和 Git 后，可以通过以下命令检查是否安装成功：

1
2
3
node -v
npm -v
git -v

如果返回版本号，说明安装成功。

安装 Hexo

使用以下命令全局安装 Hexo：

1
npm install -g hexo-cli

如果网络环境较差，可以使用淘宝的镜像源安装 Hexo：

1
cnpm install -g hexo-cli

初始化 Hexo 项目

选择一个文件夹来存放你的 Hexo 项目，执行以下命令来初始化：

1
hexo init <项目名称>

例如：

1
hexo init my-blog

初始化过程中如果遇到卡顿，可以按下 CTRL + C 终止。然后进入项目目录：

1
cd my-blog

安装项目依赖：

1
npm install

遇到 SSL 错误的解决方案

如果遇到 SSL 证书错误，可以通过以下命令关闭 Git 的 SSL 验证（仅建议在开发环境中使用）：

1
git config --global http.sslVerify false

选择并安装主题

  1. 选择一个 Hexo 主题（例如 Butterfly）。

  2. 访问主题的 GitHub 页面，点击 Code，下载压缩包。解压到 Hexo 项目的 themes 目录下，或直接使用 Git 克隆主题：

    1
    git clone https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

  3. 修改 Hexo 根目录的 _config.yml 文件，设置主题名称：

    1
    theme: butterfly

本地生成和预览

  1. 清理缓存文件：

    1
    hexo clean

  2. 生成静态文件：

    1
    hexo generate

  3. 启动本地服务器进行预览：

    1
    hexo server

    可以将命令写在一起hexo cl && hexo g && hexo s
    在浏览器中访问 http://localhost:4000 即可查看博客效果。

部署博客

部署到 GitHub

  1. 在 GitHub 上创建一个仓库来保存你的 Hexo 博客代码。

  2. 安装 Hexo 的部署插件：

    1
    npm install hexo-deployer-git --save

    或使用淘宝镜像源：

    1
    cnpm install hexo-deployer-git --save

  3. 配置 Hexo 部署信息，修改根目录下的 _config.yml 文件，添加以下内容：

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://<你的访问令牌>@github.com/你的用户名/你的仓库名.git
      branch: main

    示例配置：

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://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@github.com/xyuns-cn/xyunblog.git
      branch: main

  4. 使用以下命令将本地生成的静态文件推送到 GitHub：

    1
    hexo deploy

部署到 Vercel 等免费容器

如果希望使用免费容器服务部署博客，可以考虑 Vercel 等平台。

  1. 使用 GitHub 账户登录 Vercel 并授权。
  2. 通过 Vercel 同步你的 GitHub 仓库，即可轻松将博客托管在互联网上。

Hexo常用命令

以下是Hexo的一些常用命令，可以帮助你更高效地管理博客：

基本命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 创建新文章
hexo new "文章标题"

# 创建新页面
hexo new page "页面名称"

# 生成静态文件
hexo generate 或 hexo g

# 启动服务器预览
hexo server 或 hexo s

# 部署网站
hexo deploy 或 hexo d

# 清除缓存
hexo clean

# 列出网站信息
hexo list

组合命令

1
2
3
4
5
6
7
# 清除缓存、生成静态文件并启动服务器
hexo clean && hexo generate && hexo server
或简写：hexo cl && hexo g && hexo s

# 生成静态文件并部署
hexo generate && hexo deploy
或简写：hexo g && hexo d

自定义文章模板

你可以在 scaffolds 目录下修改或创建自己的文章模板，如修改 post.md 来自定义新建文章的默认内容。

总结

通过以上步骤，你应该已经成功安装并配置了 Hexo 博客，并能够将其部署到 GitHub 或其他平台。借助这些常用命令，你可以更高效地管理和更新你的博客。记得根据需求不断调整和优化主题及功能，打造属于自己的独特博客系统。