欢迎来到我的博客 on Niu Weihao Blog

探索hugo博客搭建

Mon, 24 Aug 2026 15:18:15 +0800

博客搭建基本教程

这是我使用hugo框架构建博客的一个经验，价值不大，因为市面上有更为详细且官方的指导性文件。我主要谈一下我对hugo项目本身的理解。

项目架构

1my-site/
2├── archetypes/     # 内容模板，每次使用hugo new <path>/file.md 会自动使用这个文件夹里面<path>.md的模板初始化
3├── assets/         # 资源文件
4├── content/        # 内容源文件，主要的文章，数据都在这里
5├── data/           # 数据文件
6├── layouts/        # 布局模板，可以预设一些模板，用于展示，可以覆盖theme上的布局
7├── static/         # 静态文件（直接复制）
8├── themes/         # 主题，其他开发者设计好的主题结构，可以直接配置使用
9└── hugo.toml       # 配置文件，用于配置一些关键信息

项目基本命令

 1# 创建站点目录（替换 my-blog 为你的站点名称）
 2hugo new site 牛伟豪的博客
 3# 进入站点目录
 4cd 牛伟豪的博客
 5# 初始化 Git 仓库（后续主题部署需要）
 6git init
 7# 新建关于页
 8hugo new about.md
 9# 启动服务
10hugo server
11hugo server -D （带预览）

项目构建参考文档

我的项目地址也已经开源，地址：https://github.com/Niuwh/blog