修改：
12.17 优化结构和大纲

一、准备工作

1.安装Node.js

Hexo 基于 Node.js，首先需要安装 Node.js 和 npm（Node.js 包管理器）

Windows 用户

  1. 访问 Node.js 官网

        https://cloudflareimg.cdn.sn/i/693e9de892828_1765711336.webp

  2. 下载 LTS（长期支持）版本

  3. 运行安装程序，按照向导完成安装

  4. 验证安装（打开命令提示符或 PowerShell）：

1
2
    node --version
    npm --version

macOS 用户

方法一：使用 Homebrew（推荐）

1
brew install node

方法二：直接下载安装包

  1. 访问 Node.js 官网

  2. 下载 macOS 安装包

  3. 双击安装

Linux 用户（Ubuntu/Debian）

1
2
3
# 使用 NodeSource 仓库安装最新 LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

2.安装 Git

Git 用于版本控制和部署

Windows 用户

  1. 访问 [Git 官网](Git - 下载 - Git 版本控制系统)

  2. 下载 Windows 版本

  3. 安装时注意勾选 “Add to PATH”

macOS 用户

1
brew install git

Linux 用户

1
sudo apt install git

二、Hexo 安装步骤

1. 安装 Hexo 命令行工具

打开终端（Windows 用户使用命令提示符或 PowerShell），执行：

1
npm install -g hexo-cli

  • npm install: npm 安装命令

  • -g: 全局安装，使 hexo 命令在任何目录可用

  • hexo-cli: Hexo 命令行工具包

2. 验证 Hexo 安装

1
hexo --version

应该显示 Hexo 及相关组件版本信息

创建新的 Hexo 项目

1.创建并进入一个文件夹

创建并进入一个文件夹，名称不限

2.打开CMD

3.初始化

在CMD中输入并回车

1
hexo init

  • hexo init: 初始化 Hexo 项目

    初始化需要从Github中clon，可以使用学术加速等方式进行加速

4.安装项目依赖

1
npm install

这将安装 package.json 文件中列出的所有依赖包

5.项目结构说明

执行上述命令后，会创建以下目录结构：

1
2
3
4
5
6
7
/
├── _config.yml     # Hexo 主配置文件
├── package.json    # 项目依赖配置
├── scaffolds/      # 模板文件夹
├── source/         # 文章和页面源文件
│   └── _posts/     # 博客文章存放处
└── themes/         # 主题文件夹

三、 基本命令使用

1.创建新文章

1
hexo new "我的第一篇文章"

  • 会在 source/_posts/ 目录下生成 Markdown 文件

  • 文件名为 “我的第一篇文章.md”

2.生成静态文件

1
2
3
hexo generate
# 或简写
hexo g

  • 将 Markdown 文件转换为 HTML 静态文件

  • 生成的文件保存在 public/ 目录

3.启动本地服务器

1
2
3
hexo server
# 或简写
hexo s

  • 启动本地预览服务器

  • 默认地址：http://localhost:4000

  • 添加参数：hexo s -p 5000 （指定端口 5000）

4.清除缓存和生成的文件

1
hexo clean

  • 删除 public/ 文件夹和缓存

  • 解决页面更新不显示的问题

5.常用工作流程

1
2
3
4
5
6
7
8
9
10
11
12
# 1. 创建新文章
hexo new "文章标题"

# 2. 编辑文章（用你喜欢的编辑器打开）
# 文件位置：source/_posts/文章标题.md

# 3. 生成并预览
hexo clean   # 可选，清理缓存
hexo generate
hexo server

# 4. 浏览器访问 http://localhost:4000 查看效果

四、完成安装验证

  1. 在根目录执行：

    1
    2
    3
    hexo clean
    hexo generate
    hexo server

  2. 打开浏览器访问 http://localhost:4000

  3. 应该看到 Hexo 默认的 “Hello World” 页面

现在你已成功在本地安装了 Hexo！可以开始编写博客内容了。

在下一篇博客中，我将教大家如何部署到github page上，并安装插件。