文章

三次 build 环境问题实录：Turbopack 持久缓存重放旧失败、孤儿进程占端口假回归、CRLF 行尾导致 frontmatter 未剥离。附排查顺序。

从 jiusi-notes 的 v3.25.0 重构讲起：为什么把站点配置与 Markdown 内容彻底分离，配置驱动元数据的加载器如何设计，以及这中间踩过的坑。

为什么内容型技术博客选 Next.js 全家桶而不选 MDX 官方方案；静态与动态混合渲染的分区策略；自研 Markdown 管线的动机。

SSG+ISR 下的 canonical/OG/sitemap/RSS 配置，一个"每页 canonical 都指向首页"的重复内容坑，以及中文 slug 的三个注意点。

jiusi-notes 弃用 @next/mdx，自研 755 行 Markdown 渲染器。讲 XSS 转义范式、KaTeX/Mermaid 接入、TOC 一致性与四个"看着对实际错"的坑。