one博客待办

one博客：简约、唯美、丝滑且强大。

• 持续修复存在的bug & 优化一些元素的细节 & 移植好看的博客元素风格过来
• 把每一个博客元素优化到极致（漂亮 & 丝滑）
• （bug）移动端 文档库侧边栏 文件所在行宽度异常问题
• （优化）文章末尾版权提示需再优化（可借鉴 @时光）
• （优化）把hyde teek的首页打字机风格（好看的渐变色）移植过来
• （优化）把hyde teek的首页向下小箭头移植过来
• 白木/vp 简约文档风移植过来
• 如何让自己博客整体看起来更现代化（来自 @时光 建议）
• 文档库侧边栏性能优化
• 首页打开速度优化
• 首页页面加载效果优化
• 博客后台持续完善
• 鉴于 rz博客 原作者未迭代博客，后期将把one博客（基于rouxzhee，one二次开发的）开源出来
• 图标风格统一、字体风格统一、主题色风格统一

博客管理后台

加速构建时间

排查结论：慢主要不是 Hugo 本身坏了，而是体量大 + 启动流程重复构建 + 侧边栏模板开销叠加。

原因分析

1. 内容规模大（正常）

• 1631 页 + 128 个分页，全量构建约 25–35 秒 对这个体量属于可接受范围
• 瓶颈在 render pages（你截图里的 ~24.8s）

2. start.bat 启动做了两次全量构建（主要体感慢）

启动流程里在跑 hugo server 之前，又执行了一次完整 hugo build（原注释说是给 Pagefind，但 FlexSearch 已在数据生成阶段完成）。
等于：预处理 + 第一次构建 + server 再构建 ≈ 等很久才能访问

3. --disableFastRender 拖慢开发热更新

改一个文件会触发大范围重渲染，而不是只更新变更页。

4. 侧边栏模板是最大渲染热点（已优化）

--templateMetrics 显示：

根因：每篇文档用不同 cache key 渲染侧边栏，递归 partial 被重复执行十几万次；激活态其实已由 simple-sidebar.js 根据 data-path 在客户端处理。

已做优化

1. 侧边栏按分类缓存

   • 新增 sidebar-resolve-category.html
   • 侧边栏树按 categorySlug 共享缓存，去掉服务端 is-active（交给 JS）

2. 启动脚本

   • 去掉启动前多余的完整 hugo build
   • 去掉 --disableFastRender，开启快速热更新
   • 新增 bin/windows/start-quick.bat（快速启动）

3. Linux / Makefile 同步去掉 --disableFastRender

使用建议

改主题/布局后首次构建仍要 ~30s（1631 页全量）；改单篇文章后应明显更快。

后续可选优化（未做）

• 代码块高亮（9283 个 render-codeblock）是第二大头，可考虑减少不必要的代码块或拆分构建
• docs-meta.html 每页 ~32ms，已用 partialCached，收益有限
• 生产构建可用 make build-fastest 跳过非必要步骤

需要的话我可以帮你提交并推送这批性能优化改动。