hexo-next博客系统搭建

¶Hexo Next 博客系统搭建及常用操作指南

¶一、环境准备

首先需要安装必要的环境：

• Node.js (推荐 v14+)
• Git

安装完成后，通过命令行验证：

node -v  # 查看Node.js版本
npm -v   # 查看npm版本
git -v   # 查看Git版本

¶二、Hexo 与 Next 主题搭建步骤

1. 安装 Hexo 脚手架

npm install -g hexo-cli

1. 初始化博客项目

# 创建博客目录并进入
mkdir my-hexo-blog && cd my-hexo-blog

# 初始化Hexo
hexo init

# 安装依赖
npm install

1. 安装 Next 主题

# 克隆Next主题到themes目录
git clone https://github.com/next-theme/hexo-theme-next themes/next

1. 配置 Next 主题
   编辑博客根目录下的 _config.yml：

# 设置主题为next
theme: next

# 配置站点信息
title: 我的博客
subtitle: ''
description: ''
author: 你的名字
language: zh-CN  # 中文
timezone: Asia/Shanghai  # 时区

1. 初始化博客并预览

# 生成静态文件
hexo generate  # 可简写为 hexo g

# 启动本地服务器
hexo server    # 可简写为 hexo s

访问 http://localhost:4000 即可预览博客

¶三、常用命令

1. 基础命令

hexo new "文章标题"    # 创建新文章 (简写: hexo n)
hexo generate          # 生成静态文件 (简写: hexo g)
hexo server            # 本地预览 (简写: hexo s)，可加 -p 端口号指定端口
hexo deploy            # 部署到远程 (简写: hexo d)
hexo clean             # 清理缓存和生成的文件

1. 组合命令

hexo clean && hexo g -d  # 清理并生成后直接部署
hexo s -g                # 生成并预览（自动监测文件变化）

¶四、新增与发布文章

1. 创建新文章

# 创建普通文章
hexo new "我的第一篇博客"

# 创建页面（如关于页）
hexo new page "about"

文章会生成在 source/_posts/ 目录下，格式为 Markdown

1. 编辑文章
   Markdown 文章头部包含 Front-matter 配置：

---
title: 我的第一篇博客
date: 2025-09-01 10:00:00
tags:
- 教程
- Hexo
categories:
- 技术
---

这里是文章内容...

1. 部署到远程（以 GitHub Pages 为例）

• 配置 _config.yml 中的 deploy 部分：

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

• 安装部署插件：

npm install hexo-deployer-git --save

• 部署文章：

hexo d -g  # 生成并部署

¶五、其他常用操作

1. 设置 Next 主题样式
   编辑 themes/next/_config.yml 可配置主题样式：

# 选择主题风格 (有normal, muse, pisces, Gemini等)
scheme: Gemini

# 开启目录
toc:
  enable: true

# 开启评论等功能

1. 添加标签和分类页面

hexo new page tags    # 创建标签页
hexo new page categories  # 创建分类页

然后在对应页面的 Markdown 文件中添加类型声明

1. 更新 Next 主题

cd themes/next
git pull

通过以上步骤，你可以完成 Hexo Next 博客的搭建并掌握日常管理维护的基本操作