开发工具

记录博客取消 2K、4K 和超大屏专门适配的原因。我查看常用网站和 Tailwind CSS 的默认响应式方式后，没有发现页面需要随物理分辨率不断放大；相反，内容通常保持最大宽度，宽屏只增加留白。几次自定义断点还破坏了首页、文章、Tools 与 About，最终项目恢复默认断点和 max-w-7xl。

记录我把客户端、服务端和设计资料从一个 Monorepo 拆到独立仓库的过程。重点不是 git-filter-repo 命令本身，而是怎样确认 202 个文件和 89 条提交没有丢，怎样保留 .env、日志和编辑器配置，以及什么时候才能放心删除旧目录。

记录 Taro 小程序半屏抽屉的两个交互问题：图标看得见却难以点中，系统返回又会直接离开页面。文章使用 44px 触控热区与 PageContainer 假页容器，让右滑返回、安卓物理返回键和代码返回优先关闭抽屉，并说明嵌套弹窗、遮罩动画与真机验证时容易踩到的边界。

记录一次将小程序协议 Markdown 从源码内置改为运行时加载的开发过程：最初绕到对象存储、版本清单和 JSON 包装，最后收敛为启动 config 下发路径、Hono/Bun serveStatic 直接提供文件。文章也说明 MIME 类型、Docker 复制和旧客户端兼容这些容易漏掉的细节。

一次 Taro 前台分页改造记录：从用单页条数猜测是否还有下一页，到发现列表接口每次返回 total 会重复执行 COUNT，最后将列表与总数拆成两个接口，并按筛选条件缓存总数，减少空页请求和翻页开销，同时说明排序、搜索、缓存键和新旧客户端的发布顺序。

记录 Taro 微信小程序中两类容易忽略的图片请求：弹窗只用透明度隐藏时 Image 仍会加载，Swiper 一次挂载全部子项时也会批量请求。文章给出条件渲染、相邻图片窗口、全屏预览 URL 复用、视频延迟挂载及微信开发者工具网络面板验证方法，适合排查页面未操作却产生流量的问题。

记录个人博客从 WordPress 迁移到 Next.js 后的一次 SEO 整理：检查 75 篇公开文章的摘要、标题层级、旧链接和薄内容，并通过 Google Search Console 区分“已收录”与“能被搜到”。也记录关于页误设 noindex、站点介绍过时和中文大标题影响阅读的问题。

排查 Fastify 服务使用 Bun 与 ncc 打包后遗漏 bcrypt 原生二进制、Swagger UI 静态目录和 worker 的问题。文章区分已打包的 JavaScript 依赖与仍需复制的运行时文件，比较两种打包器的差异，并给出 Windows x64、Node.js 环境的产物检查方法。

整理 Node.js 包管理工作流，涵盖使用 NVM 切换版本、查看和修改 npm、Yarn registry、调整全局安装目录与缓存，以及把 npm 12 降回 Node.js 24 自带版本。文章给出 where、npm config 和缓存检查命令，用于排查版本错位、镜像残留与 PATH 命中错误。