手把手教你安装和运行 Hexo 博客框架
Hexo 是一个快速、简洁且强大的静态博客框架,非常适合个人博客搭建。本文将带你一步步完成 Hexo 的安装和运行,新手也能轻松上手!
Hexo 是一个快速、简洁且强大的静态博客框架,非常适合个人博客搭建。本文将带你一步步完成 Hexo 的安装和运行,新手也能轻松上手!
环境准备
在开始之前,请确保你的电脑已安装以下工具:
下载地址:Node.js 官方网站 推荐版本:LTS
- Node.js 和 npm
安装 Hexo
- 打开终端,安装 Hexo 的命令行工具:
npm install -g hexo-cli
选择一个空文件夹作为你的博客目录,例如 hexo-blog,然后执行以下命令:
- 创建博客项目
mkdir hexo-blog
cd hexo-blog
hexo init
安装完成后,目录结构如下:
hexo-blog/
├── _config.yml # 站点配置文件
├── package.json # 项目信息
├── scaffolds/ # 模板文件
├── source/ # 博客内容
└── themes/ # 主题文件
- 安装依赖:
npm install
运行 Hexo
- 启动本地服务器:
hexo server
- 打开浏览器,访问 http://localhost:4000,你将看到 Hexo 的默认页面。
撰写博客文章
使用命令:
- 新建文章
hexo new "文章标题"
文章文件会保存在 source/_posts/ 文件夹下,文件格式为 .md。
打开新建的 Markdown 文件,在其中撰写你的内容。例如:
- 编辑文章
---
title: 我的第一篇博客
date: 2025-06-18 10:00:00
tags: [Hexo, 博客]
---
这是我的第一篇 Hexo 博客文章!欢迎阅读!
在终端运行:
- 生成静态页面
hexo generate
如果服务器已经关闭,请重新运行:
- 再次启动服务器
hexo server
常用命令汇总
| 命令 | 作用 |
|---|---|
hexo new <标题> | 新建文章 |
hexo generate | 生成静态文件 |
hexo server | 本地预览 |
hexo deploy | 部署 |
hexo clean | 清理缓存与旧的静态文件 |
部署网站
- (推荐)SSH登入后上传到nginx指向路径即可
- (不太推荐)使用hexo-deployer-sftp插件上传,因为太久没维护了,不安全,上传推送可能不支持。使用方法
结语
恭喜你完成了 Hexo 博客的安装和运行!通过 Hexo,你可以轻松记录生活和技术点滴,还可以通过丰富的主题和插件打造个性化博客。快去试试吧!