hugo建站

发布日期： 2025-12-18 阅读量： 作者： admin

昨天搞了一天Hugo建站，那真是从零开始硬刚的，现在手指头还酸着。

一. 被静态网站种草了

老看人说静态站快得像飞，还便宜，我这人听不得“省钱”俩字。琢磨着弄个个人博客堆教程，GitHub Pages免费托管？这不就是为我量身定制的吗！直接锁定了Hugo，听说生成网页快得离谱。

二. 安装就给了个下马威

官网下载页瞅半天，Windows系统选了后缀是zip那个。解压完傻眼了，就一个*黑黢黢的躺在文件夹里。这咋用？拍脑门想起来得配环境变量。对着百度教程折腾半小时，在CMD里敲hugo version蹦出版本号那刻，差点摔键盘庆祝。

三. 生个网站骨架真费劲

开终端直奔桌面文件夹，hugo new site my_blog 一敲回车。桌面“唰”的冒出个my_blog文件夹，打开一看里面全是空的：

archetypes（这啥玩意儿？）
content（放文章的地儿）
layouts（网页排版屋？）
其他几个空文件夹干瞪眼

跟毛坯房似的，墙都没刷。

四. 挑主题挑到眼瞎

去官方主题站翻，好家伙上千个！下拉三分钟就开始暴躁。随便戳个预览图，加载慢得像乌龟。闭眼抓了个叫PaperMod的，教程多就是王道。直接克隆主题仓库扔themes里，把主题文件夹里的*拽出来覆盖根目录，手都在抖——生怕整崩了。

五. 憋出第一篇破文儿

敲命令 hugo new posts/*，content里总算有文件了。开Markdown编辑器一看，开头自动加了段配置：

title: "first post"
date: 2025-xx-xx （自动写当天）
draft: true （草稿状态还发不出去）

删掉draft那行，底下哗哗敲了几句“Hello Hugo”，保存时手滑按了三次ctrl+s。

六. 本地测试翻车现场

终端里输 hugo server -D 启动，显示跑在localhost:1313。浏览器一开，404！血压当时就上来了。翻主题文档才发现，默认首页要搞个_*，骂骂咧咧在content根目录补了文件，刷了二十次页面才刷出个标题。

七. 部署差点删库跑路

按教程初始化git仓库，add commit一顿操作。到GitHub开新仓库my_blog，把本地仓库推上去。重点来了！得进仓库设置里开GitHub Pages，选gh-pages分支当源。搞完死活打不开网页，发现public文件夹没生成。赶紧查，原来得先用 hugo 命令生成网页文件，再推public文件夹到gh-pages分支。拿Git Bash折腾分支切换时，生怕把本地文件删光了。

在GitHub仓库设置里看到绿色钩子“Your site is published at...”，瘫在椅子上啃完半包薯片。这玩意儿看着简单，坑比路边烧烤摊的竹签子还多。

上一篇: 购物网站建立效果如何？引流销量提升大秘诀！

hugo建站

随便看看