一直想有一个不依赖平台的地方,存放那些散落在笔记软件、聊天记录和脑子里的技术经验。于是有了这个站点:小鱼技术栈。

它不追热点,也不追求日更,只希望每解决一个问题,就留下一条以后还能找到的路。

为什么是 Hexo + Butterfly

Hexo 的定位很纯粹:Markdown 写文章,一条命令生成静态页面,没有数据库,也没有需要长期维护的后台。对个人博客来说,这种简单本身就是一种可靠性。

Butterfly 则补齐了阅读体验:文章卡片、目录、搜索、归档、标签、暗色模式,基本开箱即用。它允许你只改配置就得到一个完整的站点,也留了足够的 CSS 和模板空间做自己的风格。

工具应该降低表达的摩擦,而不是成为表达本身。

这套站点怎么跑起来

站点完全静态化,文章和图片都放在本地,不依赖外部图床。核心命令只有几条:

# 安装依赖
npm install

# 本地预览(默认 4000 端口)
npm run server

# 生成静态文件到 public/
npm run build

# 重新构建并重启本机静态服务
npm run release

生成后的 public/ 可以直接交给 Nginx、GitHub Pages、Cloudflare Pages 或任意对象存储,不需要 Node.js 运行时。

已经打开的能力

  • 本地全文搜索:不依赖第三方搜索服务,构建时生成索引。
  • 亮 / 暗色模式:默认深海蓝暗色主题,也可以切回亮色。
  • 文章目录与相关推荐:长文阅读时快速定位。
  • 归档、分类、标签:按时间或主题重新组织内容。
  • RSS 与 sitemap:/atom.xml 和 /sitemap.xml 开箱可用。
  • 自定义 404:静态站点也可以有完整的错误页。

接下来写什么

后端开发、工程实践、工具效率,以及一些真实项目里的取舍和复盘。尽量写“为什么”,也尽量让步骤可复现。

如果这些内容刚好帮你少踩一个坑,那这个博客就有意义。

最后

先把第一篇文章发出来,比把博客装修到完美更重要。

剩下的,慢慢迭代。