从零开始：我如何用 Hexo + Vercel + Obsidian 打造全自动化博客

为什么我选择自建博客？

作为一名大三的软件工程学生，我站在 2026 年的节点上，焦虑与兴奋并存。传统的代码 CRUD 已经无法满足我，我正准备一头扎进 大模型应用开发 和 AI Agent 生态的深水区。从 RAG的实战到 Agent的架构设计，我每天都在摄入海量的新知。

在这个过程中，我意识到：我需要一个沉淀思考的容器。

为什么我拒绝 CSDN 和知乎甚至是b站？

我渴望一个纯粹的表达空间，而非寄人篱下。我不希望我的思考被淹没在 CSDN 的广告弹窗中，也不想在知乎情绪化的辩论场里空耗精力。

甚至，我也开始警惕 b站上那些变味的“免费资源”。很多时候，“分享”变成了“诱饵”，评论区变成了“漏斗”，最终目的都是兜售课程。这种风气，正在扼杀技术圈本该有的开源精神。

我始终坚信：在这个时代，获取知识的门槛已经降到了地板上，但筛选知识的门槛却升到了天花板。 真正的学习力，不是买多少课，而是是否有意识去触达源头——无论是官方文档还是前沿文献。

因此，这块数字领地不仅是我的笔记库，更是我的投名状。它将如实记录我如何利用一手信息解决问题，见证我从一名大三学生向 开发者 和蜕变的完整路径。

痛点：作为程序员的懒与洁癖

作为一个典型的 ENTP 和程序员，我有着极度的效率洁癖。我最讨厌的事情就是繁琐的重复性劳动。

如果写一篇博客需要我：

打开浏览器登录后台；
手动调整排版；
处理图床链接；
点击发布等待审核…

那我敢打赌，我的更新频率绝对撑不过两周。我的精力应该花在Prompt Engineering 和 算法逻辑 上，而不是花在“发布博客”这个动作本身。

我的终极目标：无感发布

所以，我给自己定下了一个近乎苛刻的目标：极致的自动化。

写作端： 必须是我最熟悉的本地环境，支持 Markdown，沉浸式输入。
发布端： 零操作。当我按下 Ctrl + S 或者执行一个简单的 Git 命令时，剩下的事情——编译、构建、部署、CDN 分发——必须由流水线自动完成。

成果展示：这两天折腾的结晶

这篇文章，就是我这两天暂时放下手头的 AI 项目，专心“折腾”出来的最终成果。这套方案打通了从本地笔记到公网展示的“最后一公里”，它让我确信：

在本地写下的每一个字符，下一秒就能成为互联网上的一束光。

我的技术栈

为了实现“免费、快速、自动化”的目标，我精选了以下组合：

核心引擎： Hexo
- 理由： 基于 Node.js，速度快，生态极其丰富。
托管平台： Vercel
- 理由： 提供了全球 CDN 加速，对 Hexo 支持极好，且完全免费。最重要的是，它支持 Git 自动化构建。
UI 主题： Redefine
- 理由： 极致的简约风格，拥有细腻的磨砂玻璃质感。我看腻了那些满屏特效的主题，Redefine 的磨砂质感让我的心能静下来。
写作终端： Obsidian
- 理由： 地表最强 Markdown 编辑器，配合插件可以实现“本地即云端”。还不用担心公司倒闭。
图床方案： PicGo + GitHub + jsDelivr
理由： 彻底解决 Markdown 本地图片无法在线显示的问题，实现“复制即上传”。

搭建过程复盘

1. 放弃 Hugo，拥抱 Hexo

一开始我尝试了 Hugo 的 Stack 主题，但在 Vercel 上部署时遇到了极其顽固的环境变量问题（。

Lesson Learned: 在 Vercel 上，Node.js 生态才是“亲儿子”，兼容性远好于 Go 生态。果断止损，切换到 Hexo，果然一路绿灯。

2. 网络环境的坑

在本地配置 Hexo 时，最常见的问题就是网络。
由于国内网络环境的原因，npm install 和 git push 经常超时。

解决方案：

NPM 加速： 必须配置淘宝镜像源。

1	npm config set registry [https://registry.npmmirror.com](https://registry.npmmirror.com)

Git 代理： 这是一个大坑。开启代理软件后，必须显式地告诉 Git 走哪个端口（比如 7897），否则 Git 还是会直连然后报错。

3. 主题整容

默认的 Landscape 主题实在太复古了。我通过修改 _config.yml 引入了 `hexo-theme-redefine。
Redefine 给我的第一印象是克制。它没有满屏乱飞的特效，而是把功夫下在了排版和微交互上。配置过程也非常顺滑，我只需要在配置文件里简单调整，就实现了带有磨砂效果的导航栏、沉浸式的 Hero 封面以及非常护眼的夜间模式。这种“开箱即用”的高颜值，让我能把更多时间花在写代码而不是写 CSS 上。

4. 交互升级：让静态博客拥有灵魂

静态博客最大的痛点就是没有数据库，无法原生支持评论。

最终选择：Giscus

我最终选择了 Giscus。
它利用 GitHub Discussions 来存储评论数据。这是一个天才的设计：

0 成本： 借用 GitHub 的服务器，完全免费。
0 数据库： 不需要维护 MySQL 或 MongoDB。
极其安全： 只有拥有 GitHub 账号的开发者才能评论，天然过滤掉了垃圾广告。

核心黑科技：Obsidian 全自动化工作流

这是我最得意的一步。我不想每次写完文章都要打开终端敲 git add, git commit, git push。

我利用 Obsidian 的插件实现了无感发布：

1、 Templater：自动生成文章“身份证”

Hexo 的文章需要一个 YAML 头部（Front-matter）来记录标题、时间等信息。
我配置了 Templater 插件，一旦我在 _posts 文件夹下新建文件，它会自动插入以下模板：

---
title: <% tp.file.title %>
date: <% tp.file.creation_date("YYYY-MM-DD HH:mm:ss") %>
tags: []
cover: 
---

2. PicGo + Image Auto Upload：图片瞬移术

这是最让我爽的一个环节。以前写博客最烦的就是传图。现在的流程是：

本地截图
Obsidian 里粘贴。
魔法发生： PicGo 在后台自动将图片上传到我的 GitHub 仓库，并利用 jsDelivr 全球加速，最后自动把 Markdown 里的本地路径替换成 CDN 链接。整个过程不到 1 秒，我甚至不需要离开编辑器。

3. Obsidian Git：写完即发布

我不想每次写完都要打开终端敲 git add / commit / push。通过配置 Obsidian Git 插件，通过快捷键手动触发。

我在本地按下保存 -> GitHub 收到推送 -> Vercel 触发构建。
两分钟后，就能看到我的新文章。

4. 双屏联动

虽然发布是自动的，但我保留了 hexo s 本地预览的习惯。

右屏： Obsidian 沉浸式写作。
左屏： localhost 实时预览 Redefine 主题的渲染效果。 Hexo 的热重载让我能实时确认排版和代码高亮，确保发出去的内容是完美的。

Latentice's Blog