推荐用 Hugo 等静态博客生成器而非动态框架，因其编译快、部署简、安全稳定；配合 Git+CI 可自动更新，借助 Netlify CMS 可视化编辑，Markdown 专业可靠；最小步骤包括创建站点、引入主题、写 Markdown、本地预览、ghp-import 部署至 GitHub Pages。
直接用现成的静态博客生成器（比如 Hugo 或 Jekyll）搭一个可发布的博客网站，比从零写后端+数据库快得多，也更安全稳定。除非你明确想练手全栈开发，否则不建议自己实现用户登录、文章存储、评论系统这些模块。
选静态生成器还是动态框架？
静态生成器把 Markdown 写的文章编译成纯 HTML 文件，部署到 GitHub Pages、Vercel 或任意静态托管服务即可访问；动态框架（如 Django、Express）需要服务器运行、数据库维护、HTTP 路由和模板渲染——对个人博客属于过度设计。
常见误判点：
- 以为“静态 = 不能更新”：其实配合 Git 提交 + CI 自动构建，
git push就能刷新网站 - 以为“没后台就难管理”：可以用
Netlify CMS或Forestry接入可视化编辑界面 - 以为“Markdown 不够专业”：主流技术博客（如 Vue 官方文档、Rust Book）全靠 Markdown + 静态生成
用 Hugo 搭建的最小可行步骤
Hugo 编译极快、单二进制无依赖、主题生态丰富，适合快速启动。
实操要点：
- 安装后运行
hugo new site myblog创建项目目录 - 用
hugo new theme mytheme或直接git submodule add引入成熟主题（如ananke、hello-friend-ng） - 在
content/posts/first-post.md里写带 front matter 的 Markdown，例如：--- title: "我的第一篇博客" date: 2024-05-20 draft: false ---
- 运行
hugo server -D本地预览，hugo命令生成public/目录用于部署
部署到 GitHub Pages 的关键配置
GitHub Pages 默认只认 gh-pages 分支或 docs/ 目录，但 Hugo 输出的是整个 public/ 内容。容易卡住的环节：
- 必须在项目根目录创建
.gitignore，排除public/和resources/，否则 git 会报错 - 用
ghp-import -b gh-pages public（需先pip install ghp-import）把public/推送到gh-pages分支 - GitHub 仓库 Settings → Pages → Source 选
gh-pages branch / (root) - 自定义域名要配
CNAME文件，并在 DNS 设置 A 记录指向185.199.108.153等 GitHub IP
真正花时间的不是写代码，而是决定 URL 结构（/posts/xxx 还是 /2024/05/xxx）、选字体、调暗色模式切换逻辑、处理图片懒加载——这些细节才影响读者是否愿意多停留几秒。
