安装构建

约 1130 字大约 4 分钟

2026-04-05

环境准备

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

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 官方文档或寻求社区帮助。