🚀 开始使用 Hugo 博客

快速上手指南，让您快速掌握 Hugo 的基本使用方法

📖 什么是 Hugo？

Hugo 是一个用 Go 语言编写的静态站点生成器，它是目前最快的静态网站构建工具之一。

✨ Hugo 的优势

  • ⚡ 极速构建 - 生成速度极快，构建大型站点只需几秒钟
  • 🎯 简单易用 - 命令行界面简洁，学习曲线平缓
  • 🎨 主题丰富 - 拥有众多精美的主题可供选择
  • 🔧 高度可定制 - 支持丰富的配置选项和自定义功能
  • 📦 无需依赖 - 单个二进制文件，无需运行时环境

📝 创建新文章

使用 Hugo 创建新文章非常简单：

hugo new posts/your-post-title.md

这个命令会在 content/posts/ 目录下创建一个新的 Markdown 文件，包含基本的 front matter（前置元数据）。

文章格式示例

+++
date = '2025-11-15T17:55:25+08:00'
draft = false
title = '文章标题'
description = '文章描述'
tags = ['标签1', '标签2']
+++

# 文章内容

这里是文章正文...

👀 本地预览

在开发过程中，您可以启动本地开发服务器实时预览：

hugo server -D

或者使用更详细的选项：

hugo server -D --bind 0.0.0.0 --port 1313

然后在浏览器中访问 http://localhost:1313 即可查看您的博客。

💡 提示：-D 参数表示包含草稿（draft）文章，--bind 0.0.0.0 允许从其他设备访问，--port 可以指定端口号。

🏗️ 构建站点

当您准备部署站点时，使用以下命令生成静态文件：

hugo

或者使用压缩版本（推荐）：

hugo --minify

生成的文件将在 public/ 目录中，您可以将这个目录部署到任何静态网站托管服务。

常用构建选项

  • --minify - 压缩 HTML、CSS 和 JavaScript
  • --cleanDestinationDir - 构建前清理目标目录
  • --gc - 运行一些清理任务（移除未使用的缓存文件）

🎨 主题

本博客使用了 PaperMod 主题，这是一个功能丰富且美观的主题。

PaperMod 的特色功能

  • 🌓 支持深色/浅色主题切换
  • 🔍 内置全文搜索功能
  • 📱 完全响应式设计
  • 🎯 多种首页模式（Regular、Home-Info、Profile）
  • 📊 阅读时间统计
  • 🏷️ 标签和分类支持

📚 更多资源

🎯 下一步

  1. ✅ 熟悉 Markdown 语法
  2. ✅ 探索 Hugo 的配置文件选项
  3. ✅ 自定义主题样式
  4. ✅ 添加更多内容

希望这个指南能帮助您更好地使用 Hugo！如果您有任何问题，欢迎在博客中留言讨论。😊