如何运用HEXO在电脑本地搭建网站？小白可学！

一、安装准备

1. 安装 Node.js

   • 访问 Node.js 官网，下载并安装 LTS 版本（如 18.x）。

   • 安装时勾选 Add to PATH，确保 Node.js 和 npm 添加到系统环境变量。

2. 安装 Git

   • 访问 Git 官网，下载并安装。

   • 安装时勾选 Use Git from the Windows Command Prompt 以添加环境变量。

3. 验证安装，运行cmd命令提示框：

4. node -v  # 应输出 v18.x.x

5. npm -v   # 应输出 9.x.x

6. git --version  # 应输出 git version 2.x.x

二、初始化 Hexo 项目

1. 创建项目文件夹

   mkdir E:\my-hexo-site  # 新建文件夹
   cd E:\my-hexo-site     # 进入文件夹

2. 初始化 Hexo

   npm install -g hexo-cli  # 全局安装 Hexo
   hexo init                # 初始化项目
   npm install              # 安装依赖

3. 项目结构说明

   my-hexo-site/
   ├── _config.yml    # 主配置文件（核心！）
   ├── source/        # 存放文章和页面
   ├── themes/        # 存放主题
   ├── public/        # 生成的静态文件（运行 hexo g 后出现）
   └── package.json   # 项目依赖配置 

三、配置 Hexo

1. 修改主配置文件（_config.yml）

   • 文件路径：E:\my-hexo-site\_config.yml

   • 关键配置项：

     # 网站基本信息
     title: 我的博客
     subtitle: 欢迎来到我的博客
     description: "记录技术与生活"
     author: 你的名字
     language: zh-CN  # 设置为中文
     
     # 主题配置
     theme: next      # 使用 NexT 主题

2. 安装 NexT 主题

   git clone https://github.com/next-theme/hexo-theme-next themes/next

3. 验证主题配置

   • 确保 themes 目录下存在 NEXT 文件夹。

四、生成与预览网站

1. 清理缓存并生成静态文件

   hexo clean  # 清理缓存
   hexo g      # 生成静态文件（生成到 public/ 目录）

2. 启动本地服务器

   hexo s  # 启动服务，默认端口 4000

3. 访问本地网站

   • 打开浏览器，输入 http://localhost:4000。

   • 若看到页面，表示成功；若提示“拒绝连接”，继续排查。

五、常见问题与解决

问题	解决方案
hexo 命令未找到	重新安装 Hexo：npm install -g hexo-cli
主题未生效	检查 _config.yml 中的 theme: next 和 themes/next 目录是否存在
页面样式错乱	清理缓存：hexo clean，并重新生成：hexo g
Git 克隆失败	手动下载 NexT 主题，解压到 themes/next

如果提示命令提示框提示“HEXO不是内部或外部命令，也不是可运行的程序 或批处理文件。” 说明安装文件位置或者系统环境未设置，有两种解决方式：1、网上有系统环境编辑教程，自己搜。2.命令写成"npx hexo clean"也就是加入“npx”去调用HEXO执行，如下图所示：

 

六、测试 

最后在浏览器输出http://localhost:4000/即可输出网页（如下图所示），其他网页参数和样式、文案等自行设计更改相关文件参数即可！