Hugo 个人博客日常写作与发布指南

适用环境：Hugo 博客（“十年"自创主题）· 服务器 Debian 12

本文档记录了从本地编写 Markdown 到最终在服务器上线展示的完整流程。

核心路径备忘

博客源码目录：/root/myblog/
文章存放路径：/root/myblog/content/posts/
图片存放路径：/root/myblog/static/images/
在线站点地址：https://676899.xyz/

步骤一：本地编写文章

在本地电脑上使用常用的 Markdown 编辑器（如 VS Code、Typora、Obsidian 等）新建 .md 文件。

文件最上方必须包含 Hugo 的 Front Matter（元数据头部），正文开头加"适用环境"引用块：

---
title: "你的文章标题"
date: 2026-10-16T20:00:00+08:00
tags: ["标签1", "标签2"]
categories: ["分类名"]
---

> 适用环境：xxx（如：三星 One UI 6.1 · KernelSU）

正文编写要点：

title/date/tags/categories 四件套一次写全；
支持所有标准 Markdown 语法、表格以及带高亮的代码块。

步骤二：文章配图处理（可选）

如果文章需要插入本地截图或图片：

上传图片：将图片上传至服务器的 /root/myblog/static/images/ 目录（例如 demo.png）。
在文章中引用：在 Markdown 正文中直接使用绝对根路径调用：
```
![示例图片](/images/demo.png)
```
Hugo 编译时会自动把 static/ 目录下的所有资源映射发布到网站根目录。

步骤三：上传与发布

上传文章：使用 SFTP 工具（如 WinSCP，连 155.103.157.117:22222）将写好的 .md 文件上传到 /root/myblog/content/posts/（已发布的文章直接同名覆盖）。
终端执行发布：SSH 登录服务器，运行：
```
hugo -s /root/myblog --gc --minify
```
主题、配置大改后需要全量重建时，加 --cleanDestinationDir。

步骤四：检查与验证生效

打开浏览器访问：https://676899.xyz/
缓存处理：若浏览器仍显示旧内容，按 Ctrl + F5 强制刷新，或用无痕窗口查看。

步骤五：配置一键发布脚本（可选）

在服务器上创建快捷指令，以后一行命令搞定：

cat << 'EOF' > /usr/local/bin/deploy-blog
#!/bin/bash
set -e
echo "==> 正在编译..."
hugo -s /root/myblog --gc --minify
echo "==> 发布完成！请访问 https://676899.xyz/"
EOF
chmod +x /usr/local/bin/deploy-blog

之后每次传完 .md，终端输入 deploy-blog 即可。