Hello, World — 我的博客开篇

为什么写这个博客

写给正在学同一门技术的同学。

我开过太多次”博客”。在 Notion 写过几篇，在语雀写过几篇，在 GitHub Pages 上用 Hexo 搭过一个半成品。但都没坚持下去——要么是”写给自己看”的借口太单薄，要么是写作工具和发布流程之间差了一道看不见的墙。

这一次我想清楚三件事再动手：

1. 写给具体的人。不是写给”未来的我”这种模糊的客体，是写给三年后想换工作的我、正在学 Vue 的同学。
2. 写作流要顺。一条 pnpm new 命令 + 编辑器内写完即部署，零摩擦。
3. 样式要配得上内容。赛博霓虹不只是好看——它是一种对”工程感”的视觉承诺。代码是这个博客的主角，配色是它的滤镜。

这个博客会写什么

三类内容，分别对应三类读者：

学习笔记

学一门新技术时的速通笔记 + 关键概念梳理 + 踩坑现场。读者：和我一样在学的同学。

项目复盘

我做过的、还在做的项目。我会挑一个最复杂的（zhikao-cloud）作为开篇案例。

工具流

我的开发环境、IDE 插件、效率工具。读者：所有想优化工作流的人。

技术栈（写在这里也算学习笔记的备份）

层级	选型	理由
框架	Astro 5	Islands 架构，重动画不影响首屏
样式	Tailwind CSS	霓虹配色 token 化
内容	MDX	Markdown 里能塞 React 组件
代码高亮	Shiki（内置）	零配置，主题丰富
搜索	Pagefind	静态构建索引，零后端
评论	Giscus	GitHub Issues 驱动，0 维护
部署	GitHub Actions	push 即部署，零成本

为什么不选 VitePress / Next.js / Hugo

• VitePress：偏工程师默认审美，赛博风需要重写 default theme，魔改量大。
• Next.js：炫酷上限高，但静态导出有 basePath / Image 组件配置坑，且构建慢。
• Hugo：构建最快，但 Go template 改结构累，赛博风主题少。

Astro 在”现成模板数 + 自研自由度 + 部署无坑”三角里是当下最优解，未来 2 年不会大改。

怎么部署

git push origin main
# GitHub Actions 跑完即可访问
# https://www.personalblog.website/

整个过程我把它写成了 .github/workflows/deploy.yml，复制即用。

---

下一篇文章我会写zhikao-cloud 项目复盘——讲讲我为什么做这个项目、技术选型怎么想的、踩过哪些坑、数据如何。