跳到主要内容

安装构建

环境准备​

在开始之前，请确保您的电脑上已经安装了以下两个工具：

1. Node.js​

Hexo 基于 Node.js 开发。请访问 Node.js 官网 点这里 下载并安装长期支持版（LTS）。安装完成后，在命令行中输入以下命令来验证是否安装成功：

node -v
npm -v

2. Git​

Git 用于将您的博客代码提交到远程仓库。请访问 Git 官网 下载并安装。安装完成后，在命令行中进行全局配置：

git config --global user.name "您的GitHub用户名"
git config --global user.email "您的GitHub邮箱"

安装 Hexo​

环境准备就绪后，我们就可以通过 npm 来安装 Hexo 命令行工具。打开您的命令行终端（如 PowerShell、Terminal 等），输入以下命令：

npm install -g hexo-cli

安装完成后，可以通过以下命令来验证 Hexo 是否安装成功：

hexo -v

初始化博客​

现在，让我们创建博客项目。

1. 创建项目目录​

在您希望存放博客文件的目录下，执行以下命令来初始化一个名为 my-blog 的项目：

hexo init my-blog

2. 进入项目目录​

cd my-blog

3. 安装项目依赖​

npm install

本地预览​

依赖安装完成后，您就可以在本地预览博客了。

1. 启动本地服务器​

在博客根目录（my-blog）下，运行以下命令启动本地服务器：

hexo server

您也可以使用简写命令：hexo s

2. 访问博客​

打开浏览器，访问 http://localhost:4000/，您就能看到 Hexo 的默认博客页面了。

创建与编辑文章​

Hexo 使用 Markdown 格式来撰写文章。

1. 创建新文章​

在博客根目录下，执行以下命令创建一篇新文章：

hexo new "我的第一篇博客"

这个命令会在 source/_posts/ 目录下生成一个名为 我的第一篇博客.md 的 Markdown 文件。

2. 编辑文章内容​

使用您喜欢的文本编辑器（如 VS Code、Notepad++ 等）打开刚刚生成的 .md 文件。您会看到文件顶部有一段由 --- 包裹的 Front-Matter 配置区，下面是文章的正文区域。

Front-Matter 示例​

---
title: 我的第一篇博客
date: 2026-03-29 10:00:00
tags:
- Hexo
- 教程
categories:
- 技术
---

正文内容​

在 --- 下方，您就可以使用标准的 Markdown 语法来编写文章内容了。

部署到 GitHub Pages​

为了让全世界都能看到您的博客，我们将它部署到 GitHub Pages。

1. 创建 GitHub 仓库​

在 GitHub 上创建一个新的仓库，**仓库名必须为 **您的GitHub用户名.github.io。例如，如果您的用户名是 johndoe，仓库名就应该是 johndoe.github.io。

2. 配置 Hexo​

打开博客根目录下的 _config.yml 文件，拉到文件最底部，找到 # Deployment 部分，修改为以下内容：

deploy:
  type: git
  repo: https://github.com/您的用户名/您的用户名.github.io.git
  branch: main

请将 您的用户名 替换为您自己的 GitHub 用户名。

3. 安装部署插件​

在博客根目录下，执行以下命令安装 Git 部署器：

npm install hexo-deployer-git --save

4. 一键部署​

现在，您可以使用一条命令完成博客的生成和部署：

hexo clean && hexo generate && hexo deploy

您也可以使用简写：hexo clean && hexo g && hexo d

执行后，等待片刻，部署成功的信息会出现在命令行中。

5. 访问您的博客​

部署成功后，访问 https://您的用户名.github.io 即可看到您刚刚搭建好的博客网站！

常用命令速查​

命令说明
hexo new "文章标题"创建一篇新文章
hexo server 或 hexo s启动本地服务器，用于预览
hexo generate 或 hexo g生成静态网页文件
hexo deploy 或 hexo d部署博客到远程仓库
hexo clean清除缓存文件，解决一些显示异常问题

常见问题解决​

1. 部署失败​

如果部署失败，请检查：

  • GitHub 仓库名是否正确
  • 网络连接是否正常
  • 是否安装了部署插件

2. 本地预览端口冲突​

如果端口被占用，可以使用以下命令指定其他端口：

hexo server -p 4001

3. 主题更换​

Hexo 支持丰富的主题，您可以在 Hexo 主题官网 选择喜欢的主题进行安装。

祝您搭建博客顺利！如果有任何问题，欢迎查阅 Hexo 官方文档或寻求社区帮助。