好,这个我帮你整理成一套**“标准工作流程”**,你以后每次打开 Hugo 写博客就照这个来,基本不会出错。
🧠 一句话理解流程
打开项目 → 启动预览 → 写文章 → 预览检查 → 提交发布
✅ 每次写博客的完整步骤
🟢 第一步:进入项目目录
打开终端(VS Code 或 CMD):
cd D:\projects blog\my-blog
🟢 第二步:启动本地预览(强烈推荐)
hugo server -D
👉 然后打开浏览器:
http://localhost:1313/
✔ 实时预览 ✔ 改内容自动刷新
🟢 第三步:创建新文章
hugo new posts/xxx.md
比如:
hugo new posts/ai-learning.md
🟢 第四步:写文章
打开:
content/posts/xxx.md
写:
---
title: "标题"
date: 2026-04-14
draft: false
---
这里写正文内容
👉 重点:
draft: false✅(否则不会发布)- Markdown 正常写就行
🟢 第五步:本地检查(很重要)
看浏览器:
检查:
- 样式正常 ✔
- 页面能点 ✔
- 没跳错链接 ✔
🟢 第六步:提交发布(上线)
git add .
git commit -m "new post"
git push
👉 自动触发:
- Cloudflare Pages
- 自动部署
- 网站更新
🔥 你以后只需要记住这个最简版本
hugo server -D # 本地预览
hugo new posts/xxx.md # 新建文章
# 写文章
git add .
git commit -m "update"
git push # 发布上线
⚠️ 常见坑(你一定会遇到的)
❌ 看不到文章
👉 原因:
draft: true
✔ 改成:
draft: false
❌ 样式丢失
👉 原因:
baseURL 错
✔ 用:
baseURL = "/"
❌ 图片不显示
👉 放这里:
static/images/
然后:

🧠 进阶(你后面会用到)
当你不想用 Git 写文章时:
👉 可以加:
- Netlify CMS
实现:
打开网站 /admin → 在线写 → 点发布
🚀 给你一个更高效习惯(推荐)
以后你每次写博客:
1. 开 Hugo server(一直开着)
2. 边写边看浏览器
3. 写完一次性 push
👉 这就是专业流程
🎯 总结一句话
👉 Hugo 写博客本质就是:
本地写 → 本地看 → git push → 自动上线
如果你下一步想升级体验,可以直接说:
👉 “我想实现网页直接写博客(不用 git)”
我可以帮你把 CMS(后台写作)一步步接上。