项目背景

客户是一位有 6 年经验的全栈开发者，长期在第三方平台发布技术文章，但受限于平台排版与规则，无法沉淀属于自己的内容资产。他希望搭建一个独立的个人技术博客，既作为知识沉淀的笔记库，也作为个人品牌与求职作品集的窗口，对速度与写作体验有较高要求。

客户需求

• Markdown 写作：本地写好 .md 文件推送到仓库即自动发布，无需可视化后台。
• 代码体验：支持语法高亮、行号、复制按钮与代码块主题切换。
• 内容检索：站内全文搜索，快速定位历史文章。
• 互动与订阅：评论功能与 RSS 订阅，方便读者跟踪更新。
• 极速访问：首屏秒开，零服务器维护成本。

技术方案

博客选用静态站点生成器（SSG）方案：以 Markdown 为内容源，构建时生成纯静态 HTML，部署到 CDN 边缘节点，真正做到「写完即发、全球加速、零运维」。我们对比了 Hexo、Astro、VitePress 后，结合博主熟悉度与生态选择了 Astro。

自动部署流水线

通过 GitHub Actions 监听 main 分支提交，自动执行构建并把产物同步到 CDN，整个发布过程无需人工干预：

name: deploy
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - run: npx wrangler pages deploy ./dist

代码高亮使用 Shiki 在构建期完成渲染，避免运行时引入大体积脚本；站内搜索基于构建期生成的索引文件，前端纯前端检索；评论采用 Gitalk，借力 GitHub Issues，无需自建评论服务。

静态博客的魅力在于：内容与代码同样用 Git 管理，每一次提交都是一次可追溯的发布，写作者只关心文字。

实现效果

• 首屏 LCP 0.8s，Lighthouse 性能评分 98 分。
• 月独立访问 3 万+，订阅用户超 1200 人。
• 博主写作效率提升，从排版中解放，专注内容产出。
• 年服务器成本接近 0 元，仅 CDN 流量小额计费。

项目总结

个人博客是练习工程化与持续交付的理想项目。本案例展示了 SSG + Git 工作流 + 自动部署的完整链路，14 天即交付上线。如果你也想搭建自己的博客，强烈推荐跟着我们的个人博客搭建教程一步步实操，配套开发工具知识掌握 Git 与命令行，事半功倍。