- Node.js 18+
- pnpm（推荐）或 npm
- Git
# 安装依赖
pnpm install
# 启动本地服务器
pnpm server
# 或
hexo server访问 http://localhost:4000 预览博客。
hexo new "文章标题"文章会创建在 source/_posts/文章标题.md。
hexo generate
# 或
pnpm buildhexo deploy
# 或
pnpm deployboke/
├── _config.yml # 站点配置文件
├── _config.fluid.yml # Fluid 主题配置文件
├── package.json # 项目依赖
├── scaffolds/ # 文章模板
├── source/ # 源文件
│ ├── _posts/ # 博客文章
│ ├── about/ # 关于页面
│ ├── categories/ # 分类页面
│ └── tags/ # 标签页面
├── themes/ # 主题目录
└── public/ # 生成的静态文件（hexo generate）
# 站点信息
title: Lumos # 博客名称
subtitle: '探索 · 记录 · 分享' # 副标题
author: Lu # 作者
language: zh-CN # 语言
url: https://lukangyu.github.io # 博客地址
# 主题
theme: fluid
# 部署配置
deploy:
type: git
repo: https://github.com/lukangyu/lukangyu.github.io.git
branch: main主要配置项：
- 导航菜单：
navbar.menu - 首页 Banner：
index.banner - 社交链接：
social.links - 代码高亮：
code - 数学公式：
post.math - 站内搜索：
search
详细配置请参考 Fluid 官方文档。
---
title: 文章标题
date: 2026-02-14 12:00:00
categories:
- 分类名称
tags:
- 标签1
- 标签2
---
这里是文章正文...- 将图片放在
source/images/目录 - 使用相对路径引用：
或启用文章资源文件夹（post_asset_folder: true）：
hexo new "文章标题"
# 会同时创建 source/_posts/文章标题/ 文件夹已启用 KaTeX 支持：
行内公式：$E = mc^2$
块级公式：
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$支持代码高亮：
```python
def hello():
print("Hello, World!")
```| 命令 | 说明 |
|---|---|
hexo new "标题" |
新建文章 |
hexo new page "页面名" |
新建页面 |
hexo generate |
生成静态文件 |
hexo server |
启动本地服务器 |
hexo deploy |
部署到远程仓库 |
hexo clean |
清除缓存和静态文件 |
如果在中国大陆部署时遇到网络问题，需配置 Git 代理：
# 设置代理（根据你的代理端口修改）
git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897
# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxypnpm update hexo-theme-fluid更新后检查 _config.fluid.yml 是否有新配置项。
通过思源笔记的发布工具插件，可以直接将笔记发布到本博客。
在思源笔记集市中安装「发布工具」插件。
- 点击发布工具图标
- 依次选择 通用设置 → 发布设置
- 点击 插件商店 → Github → Hexo
- 点击 启用，然后 提交
点击 通用设置 → 发布设置，找到新增的 Hexo 平台，点击 设置：
必需配置项：
| 配置项 | 值 |
|---|---|
| GitHub Token | 你的 GitHub Personal Access Token |
| GitHub 仓库 | lukangyu/lukangyu.github.io |
| 分支 | main |
| 发布目录 | source/_posts |
文件规则配置：
[yyyy]/[MM]/[filename].md
可用占位符：
[yyyy]年份，如 2026[MM]月份，如 02[dd]日期，如 14[filename]文件名[slug]别名
在 图床服务与图片存储路径 中选择 当前平台：
| 配置项 | 值 |
|---|---|
| 图片存储路径 | source/images |
| 图片链接地址 | /images |
可配置文章的默认 Front-matter：
categories:
- 默认分类
tags:
- 标签- 一键发布：点击 一键发布 → hexo 即可快速发布
- 常规发布：点击 常规发布 → Hexo 可进行个性化设置后发布
在常规发布界面：
- 取消：删除远程文章并解除关联
- 强制删除：仅解除关联（用于远程文章已删除的情况）
MIT