我的技术博客启动记录

记录这个 Astro 博客的技术选型、项目结构和后续写作计划。

工程实践AstroGitHub Pages个人网站

这篇文章是博客的起点,也是一份建站记录。目标很简单:先搭出一个可以长期维护、可以部署、可以持续写作的个人技术网站。

为什么选择 Astro

Astro 很适合内容型网站。博客文章可以直接写 Markdown 或 MDX,构建结果是静态页面,部署到 GitHub Pages 成本低、速度快,也不需要维护服务端。

当前项目已经包含:

  • Markdown / MDX 写作支持
  • 内容集合和 frontmatter 校验
  • RSS feed
  • sitemap
  • GitHub Pages 部署准备

项目结构

后续最常改动的目录是:

src/content/blog/   写博客文章
src/pages/          页面路由
src/components/     站点组件
src/layouts/        文章布局
src/styles/         全局样式

写新文章时,只需要在 src/content/blog/ 下新增一个 .md.mdx 文件。

后续计划

第一阶段先把写作闭环跑通:本地写作、构建检查、推送 GitHub、自动发布。

第二阶段再逐步增强体验,比如标签页、搜索、代码块复制、评论系统和访问统计。博客最重要的不是一开始就完美,而是可以稳定写下去。