编程笔记

按博客的实际 Git 改动，记录如何用 Bun.YAML.parse 替换 gray-matter，用 Bun.markdown 替换 marked。代码包括 frontmatter 分隔、标题与目录提取、Shiki 高亮回填、外链处理和搜索文本提取，以及内容脚本移除依赖的过程；上线后观察到内存明显下降、启动加快。

一篇 .NET 排障文章文件存在、slug 正确，也标记为公开，却在博客压测中返回 404。问题出在 Bun.Glob 默认跳过点开头的文件，文章从未进入内容索引。本文记录扫描对照、最小复现、保留 slug 的重命名修复，以及为何文件名检查必须主动包含隐藏文件才能防止复发。

给博客试用马善政、方圆体和得意黑后，最终使用 MiSans 正文与 Cascadia Mono 代码字体。本文记录预览与文章页的差别、OTS 解码失败时如何排查文件、next/font/local 的接入方式，以及两份中文字体约 9.48 MiB 的实际体积和浏览器字体命中的验证方法。

解释 TypeScript 6.0.3 为什么是最后一条 JavaScript 编译器版本线、7.0.2 为何直接进入 Go 原生实现，以及 Next.js、typescript-eslint 和 Bun 项目选择版本时真正受什么约束，也说明本次迁移暂留 5.9.3 的原因。

以内容扫描、附件读取、命令行脚本、计时和测试为例，整理 Bun.file、Bun.write、Bun.Glob、Bun.argv 与 Bun.nanoseconds 的替换方法，也说明 node:path、process.env 和测试目录 API 为什么应该保留。

解释 Next.js 的 runtime=nodejs、NEXT_RUNTIME、Node 兼容 API 与实际 Bun 进程之间的区别，并给出 node:http、node:path、process.env 和 @types/node 是否应该迁移的判断标准。

用一个 catch-all Route Handler 让 Hono 接管 Next.js 的健康检查、搜索、附件和 MCP API，解释为什么这里直接调用 app.fetch，而不是使用 hono/bun 启动第二个服务器，并为本地文件与对象存储保留替换边界。

一次旧 ASP.NET Core 系统迁入 Linux 后，数据库驱动、TLS、GC 默认策略和构建验证接连增加维护成本。本文结合 SQL Server 兼容与内存排查结果，说明我为什么减少在遗留业务中使用 .NET，而不是泛泛比较语言性能。

记录个人博客从 WordPress 迁移到 Next.js 后持续排查搜索收录的过程：从 noindex、摘要与标题结构，到百度普通收录提交、首页文章卡片的语义链接和可遍历分页，并区分页面可抓取、URL 被发现与最终进入索引之间的差异。索引量依旧偏低，这些修改还需要继续观察。