之前搭过一个博客，想着做一个有登录有后台，前端页面看到啥酷炫的效果都想克隆一份，至于结果如何：只能说如何一个惨字了得(又卡又慢，优化不完)……

本着内容至上的初心(说白了还是懒)，决定直接使用Hugo+PaperMod搭建一个极简风格的个人博客。(新手村背包Get)

为什么是 Hugo？因为快，且纯粹

很多新手玩家在起步时会纠结选择 WordPress 还是 Hugo。我的建议是：如果你想专注写作，且希望网站“秒开”，选 Hugo。

Hugo 是一个静态网站生成器。简单来说，它不像传统网站那样在你访问时才去查询数据库，而是提前把你写的 Markdown 文章“翻译”成 HTML 网页。这意味着你的网站没有后端漏洞，不需要维护数据库，而且速度快得惊人。

安装Hugo(快速方案不生效可以查看下文常规方案)

  • Windows系统： choco install hugo -y （需要先安装Chocolatey）
  • macOS系统： brew install hugo （需要先安装Homebrew）
  • Linux系统：根据发行版使用相应的包管理器安装

快速入门：第一行命令

在你的电脑上安装好 Hugo 之后（macOS 用 brew install hugo，Windows 直接下载二进制包），打开终端，输入：

hugo new site my-blog

这就是一切的开始。你会看到一个名为 my-blog 的文件夹，里面整整齐齐地躺着几个目录。此时它还是个毛坯房，没有灵魂，我们需要给它穿上一件“极简主义”的外套。

Git Submodule：管理主题的“优雅姿势”

这是本文的核心，也是很多新手玩家最容易卡壳的地方。

通常我们要换主题，最粗暴的方法是把主题包下载下来解压到 themes 文件夹。但这样做有个致命缺点：万一原作者更新了主题，修复了 Bug 或增加了新功能，你的本地代码很难同步更新。

Git Submodule（子模块） 就是为了解决这个问题而生的。它就像是在你的博客仓库里开了一扇“传送门”，直接连接到主题作者的远程仓库。

为什么要用它？

  1. 保持整洁：你的主仓库只记录一个“引用”，不会把成千上万行主题代码塞进自己的提交记录里。
  2. 一键同步：原作者更新了？你只需一条命令，就能把最新的代码“拉”回来，而不会破坏你自己的配置。

操作演示

首先，在你的博客根目录初始化 Git：

git init

然后，用 Submodule 的方式引入 PaperMod：

git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod

这里的 --depth=1 是个小技巧，它表示只拉取最近的一次提交，不下载冗长的历史记录，速度极快。

PaperMod：把极简做到骨子里

在众多的 Hugo 主题中，PaperMod 就像是一张高档的素描纸。它没有花哨的背景，甚至默认连图片都很少，但那种“高级灰”的质感和恰到好处的留白，能让读者的注意力完全回归到文字本身。

配置你的“指挥部”

打开根目录下的 hugo.toml（或 config.yml），我们要告诉 Hugo 启用这个主题。我建议新手玩家从最基础的配置开始：

baseURL = 'https://qiubuer.cn/'  # 个人网站域名，需要改成自己的
languageCode = 'zh-cn'
title = '遇事不决可问春风'  # 网站名称，需要改成自己的
theme = 'PaperMod'

[params]
    defaultTheme = "auto" # 自动切换深色/浅色模式
    showReadingTime = true # 显示阅读时间
    displayFullContent = false # 列表页只显示摘要

你会发现，PaperMod 的美感在于它对“度”的把握。它支持响应式布局，在手机上看也像排版精美的电子书。

个人经验：避开那些我踩过的坑

作为一个过来人，有几点心得我想分享给正在动手的你：

  1. 别急着改 CSS：很多小白一上来就想改字体、改颜色。相信我，先写十篇文章。PaperMod 的默认设计是经过深思熟虑的，过早地陷入样式调整会消耗你写作的热情。
  2. Markdown 是核心：Hugo 所有的内容都放在 content 文件夹下。养成良好的 Markdown 习惯（比如规范的分级标题），会让你的迁移成本降到最低。
  3. 本地预览的魅力：在终端输入 hugo server -D，然后打开浏览器访问 localhost:1313。那种你改一行代码，网页瞬间刷新效果的感觉，是任何可视化编辑器都给不了的掌控感。

末尾彩蛋

使用Trae快速搭建(Trae官网地址：https://www.trae.cn/)

稳妥方案安装Hugo

  1. 下载：
    1. gitcode下载：https://gitcode.com/gh_mirrors/hu/hugo
    2. github下载：https://github.com/gohugoio/hugo/releases
  2. 找对版本：搜索带有 hugo_extended_..._windows-amd64.zip 字样的文件（必须带 extended）。
  3. 解压：在你的硬盘（如 D:\software\hugo）新建个文件夹，把压缩包里的 hugo.exe 扔进去。
  4. 加环境变量：
    • 在 Windows 搜索框输入“环境变量”，选择“编辑系统环境变量”。
    • 点击“环境变量” -> 在“系统变量”里找到 Path -> 点击“编辑” -> “新建”。
    • 把刚才 hugo.exe 所在的文件夹路径（如 D:\software\hugo）粘进去。
  5. 重启 Trae：彻底关掉 Trae 再打开，在终端输入 hugo version 验证。

一键生成站点（核心指令）

打开 Trae，点击左侧或右上角的 “Builder” 按钮（通常是一个闪电或小锤子图标）。

将以下文字直接粘贴给 Trae：

“我想搭建一个基于 Hugo 的极简博客，使用 PaperMod 主题。请帮我完成以下任务：

  1. 在当前目录初始化 Hugo 站点。
  2. 以 Git Submodule 形式安装 PaperMod 主题。
  3. 修改配置文件：
    • 语言设为中文 (zh-cn)
    • 开启搜索功能 (Search Page)
    • 开启文章字数统计和阅读时间显示。
  4. 生成一个 deploy.sh 脚本，要求：使用 rsync 将本地生成的 public/ 目录同步到我的京东云服务器（路径：/var/www/blog）。
  5. 编写一个针对 2H4G 服务器优化的 Nginx 配置文件，包含 Gzip 压缩支持。”

写在最后：工具只是载体

搭建这个网站的过程，其实也是梳理自己逻辑的过程。从理解 Git 的分支管理，到折腾 Hugo 的参数配置，最后看到那个洁净如洗的页面出现在屏幕上，这种成就感无可替代。

但请记住，搭建博客最难的部分永远不是那几行命令，而是开始写下第一篇博客。 既然我们已经用 Hugo + PaperMod 构建了一个如此高效、简洁的环境，那就别让它空着。