用Hugo搭个人博客复盘:整整折腾几天,我踩遍了网络与工具的坑

这段时间,我想从零用Hugo搭建一个属于自己的个人博客,本以为是个很简单的事,结果前前后后耗了大量时间。走完整个流程,我收获的不只是一个博客,更是一次非常深刻的工具使用与问题解决经验。 整个搭建过程,踩坑不断,我简单记录一下: 最开始,下载Hugo和博客主题时就卡住了。因为访问GitHub速度极慢,光是下载这一步,就花了将近一个小时。 装好之后,我开始做博客归档页面。按照豆包给的代码一步步复制、修改,可页面始终显示不对。我一次次截图、反馈、修改,来回折腾了一个半小时,还是没能成功。最后实在没办法,我选择彻底推翻重来,删掉现有主题,重新换了一个主题,反而一下子就成功了。 接下来是把代码推送到远程仓库。GitHub依旧很慢,我想着换国内的码云会快一点,于是把代码传到码云。可按照指引,我始终找不到Pages部署入口,足足找了1.5小时,到处都翻遍了,就是没有,最后只能放弃,老老实实转回GitHub。 为了解决GitHub访问慢的问题,我先是手动修改DNS,效果一般;后来下载了dev-sidecar,网络才终于顺畅起来。这一步如果一开始就做,后面能少走无数弯路。 解决网络后,开始做站点托管。我先用了Vercel,但是打开页面极慢,加载一个网页要等好几分钟,好不容易同步完代码,生成的站点我依然访问不了。 又换成Coding,结果发现已经停止新用户注册了。 最后尝试Cloudflare Pages,注册、上传代码都还算顺利,但生成的网址很不稳定,有时候快,有时候半小时都打不开,最终站点还是无法正常访问。即便如此,我还是先绑定了自定义域名,目前正在等待DNS配置生效,不知道这个过程是不是需要等待24小时。 一、为什么会花这么多时间? 80%的原因,都是网络问题。 GitHub、Vercel、Cloudflare这些国外服务,网络不稳定、速度极慢、时常打不开,每一步都在无限等待。如果一开始网络就是顺畅的,整个Hugo搭建流程,正常情况下30分钟到1小时就能完全搞定。 而我之所以没有一开始就解决GitHub网络问题,本质是两个原因: 最开始我根本不理解GitHub是干嘛的,对它的作用没有概念,不知道它是存放代码的云端仓库; 我以为解决GitHub访问很慢、很复杂,后来才发现,其实并不难。 二、剩下20%的时间,花在了哪里? 一是AI给出的指导存在误差。 最开始配置归档页面时,我完全复制豆包提供的代码,可页面就是不正常。每次我截图反馈,得到的回答都是修改某处就一定能成功,我一直在这个死循环里耗着。 二是工具信息不准确。 豆包告诉我码云有Pages入口,我花了1.5小时拼命找,到处翻设置,始终找不到,最后只能放弃。 这次我最大的感悟是: 很多问题,不是在原地死磕就能解决的。 我所有真正突破的节点,都是自己跳出来:不对就换主题、不行就换平台、不纠结某一段代码、不卡死在一个工具里。如果一直盯着细节、完全跟着AI的指令死磕,只会越陷越深。 三、以后再用AI做开发,我会这么做 经过这次踩坑,我总结了一套自己使用AI辅助开发的方式: 先让AI把整体流程拆成大环节 不让自己陷入细节,先明白整个事情分为几步,环节之间是什么逻辑,心里有整体框架。 先搞懂基础概念,再动手 提前让AI讲清楚GitHub、Pages、DNS、托管这些东西是干嘛的。懂了原理,遇到问题我自己就能判断,不会盲目跟着操作。 多备几个备选方案,不吊死在一棵树上 一个主题不行就换,一个平台不行就换,不要死磕。 同时可以选用更稳定、更适合国内环境的工具,比如后续会尝试openclaw这类工具,提高效率。 总结 这次搭博客虽然折腾得很累,但特别值。 以前我只会跟着教程走,现在我真正懂了:搭建博客不只是复制代码,更是网络、工具、部署、域名一整套逻辑。 遇到问题不内耗,懂得跳出死循环、重新选择,比死磕细节更重要。

March 21, 2026 · 1 min