~
← 返回博客
·2 min read·tech

Hello, World — 这个站点的由来与技术选型

一个 AI 工程师为什么要写自己的博客，以及这个站点用 Next.js + MDX 是怎么搭起来的。

#meta#nextjs#mdx

为什么要有这个站

工作日大半时间在跟模型、数据、推理服务打交道，有些经验反复踩过、被同事问过、又懒得每次重新讲。 写下来一次，自己以后能翻、别人也能看，是最划算的事。

这里不会写"今天天气不错"，但也不只写"工业级最佳实践"。 介于两者之间——真实场景里的真实坑。

技术选型

短答：Next.js 16 (App Router) + MDX + Tailwind v4 + GitHub Pages。

类别选型为什么不是别的
框架Next.js + MDXAstro/Hugo 也行，但 MDX 让我能在文章里塞 React 组件
部署GitHub Pages免费、稳定、<username>.github.io 直接是根路径
评论Giscus静态站友好，评论存在 GitHub Discussions 里
搜索Fuse.js + 构建期索引不需要后端，~5KB JSON 解决问题

它能干什么

  • 写 MDX 文章，里面可以嵌任意 React 组件
  • 代码块由 Shiki 编译期高亮，零运行时开销
  • Cmd+K 模糊搜索标题、摘要、标签
  • 标签归档页 /tags/<tag>
  • Giscus 评论（配置好 4 个环境变量就启用）

一段示例代码

train.py
import torch
from transformers import AutoModel
 
model = AutoModel.from_pretrained("Qwen/Qwen2.5-7B")
model.train()  # ← 这里被高亮了

行号、文件名、高亮行都是 rehype-pretty-code 的能力。

接下来

  • 把过去几个月攒的草稿陆续放上来
  • 把工作里反复用到的脚本整理成「工具箱」系列
  • 一些个人经验也会写——但不会成为主旋律

如果你看到这条 hello world，说明站点至少能正常渲染 MDX 了。:)

评论系统未配置。在 .env.local 设置 NEXT_PUBLIC_GISCUS_* 后启用 Giscus。