为什么搭这个博客
写作对我来说不是单纯的输出，而是一种整理思路的方式。很多技术问题在脑子里看似已经想明白了，但只要真正落到文字里，就会暴露出边界条件、前置假设和没有想透的部分。
我希望有一个稳定的地方，记录前端工程、开发工具、个人项目和长期使用体验。它不需要追热点，也不需要迎合平台算法，只要能把问题说清楚、把过程留住，就已经完成了最重要的任务。
为什么选择自建
相比把内容完全放在第三方平台，自建博客最大的价值是“可控”。
- 内容结构可控：文章、标签、归档和 RSS 都可以按自己的方式组织。
- 发布节奏可控：不必为了平台推荐机制调整标题和表达方式。
- 技术栈可控：可以围绕阅读体验、代码展示和长期维护做取舍。
- 迁移成本可控：Markdown 文件和 Git 历史天然适合长期保存。
这并不意味着内容平台没有价值。平台适合分发，博客适合沉淀。我的做法是把博客作为内容源头，把其他平台当作分发渠道。
技术选型
| 层级 | 选型 | 说明 |
|---|---|---|
| 框架 | Astro | 面向内容站点，默认静态输出 |
| 语言 | TypeScript | 让配置、工具函数和内容模型更稳定 |
| 样式 | Tailwind CSS v4 | 轻量组织页面结构和排版细节 |
| 内容 | Markdown / MDX | 以文本写作为主，必要时插入组件 |
| 代码高亮 | Shiki | 提供稳定、清晰的代码阅读体验 |
| 部署 | Cloudflare Pages | 适合纯静态站点托管 |
选择 Astro 的原因很直接：这个站点的核心是文章，而不是复杂的前端应用。Astro 默认少发 JavaScript，静态生成能力成熟，Markdown 和 MDX 的支持也足够自然。
内容组织方式
每篇文章都是一个 Markdown 或 MDX 文件，包含 frontmatter 和正文：
---
title: "为什么我要自建一个技术博客"
description: "记录选择自建技术博客的原因。"
pubDate: 2026-03-30
tags: ["Blog", "Astro", "写作"]
draft: false
---
## 背景
正文内容从这里开始。这种方式的好处是简单、透明、可版本化。文章内容可以被 Git 管理，修改历史可以追溯，站点构建时再按统一规则生成首页、列表页、标签页、文章页和 RSS。
我希望这个博客解决什么
这个博客不会追求“功能很多”。它更像一个个人技术档案库，优先服务下面几件事：
- 记录真实工程实践，而不是只保留最终结论。
- 复盘工具选择和环境配置，减少重复踩坑。
- 写清楚技术方案背后的取舍，而不是只贴代码。
- 把零散笔记逐渐整理成可以回看的知识结构。
如果未来加入搜索、评论、项目页和统计，也会围绕这个目标展开，不会为了热闹而堆功能。
写作原则
我会尽量遵守几个简单原则：
- 先说问题，再说方案。
- 先给结论，再解释依据。
- 尽量保留上下文，不只留下命令和代码。
- 对工具和框架保持具体判断，而不是简单贴标签。
- 写可以半年后重新读懂的文章。
技术写作最难的不是把文章写长，而是把复杂问题写得有秩序。这个博客就是我练习这件事的地方。
总结
自建博客对我来说不是为了换一个发布工具，而是为了建立一个长期可维护的技术写作环境。它应该足够轻，轻到不会妨碍写作；也应该足够稳，稳到几年后仍然能继续迭代。接下来这里会主要记录前端工程、开发工具、环境配置和个人项目实践。
评论