Skip to content

改手机版,顺手把备份目录也发成了 4 个公开页面 ​

一句话结论:手机版改完,构建产物里凭空多出 4 个页面,sitemap 从 160 条涨到 164 条。不是生成器出了怪,是我们把备份目录放在了它扫描的范围里。

起因 ​

有人问了一句:官网好像没做手机适配吧?

先去核,结论是「不是零适配,是首屏破防」。断点写了 20 处、导航汉堡也在、文档页目录按钮能用,但 375px 下首页右半边整个不见了。往回查,链条挺清楚:首页一句标语带了强制不换行,最小内容宽被撑到 579px,单栏布局的自动最小宽跟着变成 581px,而全局样式里有一条「横向溢出隐藏」,于是超出部分不是出现滚动条,是直接消失。实测首页有 21 个元素越界,全是首屏那一片。观感上就是「完全没适配」。

改动的硬约束只有一条:桌面 ≥901px 视觉零变化。电脑版不用动,也不能被动到。

排查过程 ​

三个坑,都是自己造的 ​

第一个坑:备份目录被当成正文发布。 动手前照例先备份,顺手把备份放在了官网根目录。这个站点的源码目录就是根,生成器会把里面所有 Markdown 都扫成页面。于是构建完一看,多出 4 个公开 HTML,sitemap 从 160 条变成 164 条,里面还带着备份路径。把备份挪到真源之外、重建一次,回到 160 条、零污染页。结论很朴素:备份不能放在会被构建的地方。

第二个坑:内联样式其实会全局生效。 有一页早就写过一个可横滑的容器类名,想着直接复用。但页面内联的样式会被合并进全站 CSS,桌面也吃这条规则。一复用,桌面那个容器的 computed overflow-x 就从 hidden 变成 auto,正好踩中「电脑版零变化」的约束。改法是另起一个自有类名,并且把最小宽度只写在移动端样式里,桌面连 computed 值都不变。

第三个坑:量出来 472px 的差,是没等图片加载完。 做桌面新旧对照时,第一次等待 1700ms 就截图取几何数据,产品页的 scrollHeight 新旧差了 472px,后面所有元素的 top 都整齐地 +472,看着像重大回归。延长到 2800ms 再量,两边同为 4948、表格 top 同为 3434,差异消失。几何 A/B 必须用同一套静态服务、等到资源真正加载完,否则量的是加载时序不是版式。

顺带还纠正了一个取证口径:无头浏览器直接给 --window-size=375,实际视口被钳到 476px,截图是「476px 视口裁成 375px 的图」,不能当真机证据。后来改成走设备模拟接口设定宽度、高度和触摸开关,才是 375 就是 375。

验收 ​

改完在 375 / 390 / 414 三个宽度、10 个页面共 20 组上跑:裁切元素数 0,每页可视区滚动宽等于客户宽,标语恢复换行且完整两行,轮播在窄屏收成单图并带前后按钮与滑动,四列表格可以横向滑动。桌面 1440 下新旧产物对照 9 页 × 29 元素 × 22 字段,0 项差异,逐页滚动宽高一致。

结论 ​

  • 首屏「没适配」的根因是一句强制不换行把布局撑爆,再加全局溢出隐藏把溢出变成消失;修法是让标语在窄屏正常换行、单栏改 minmax(0,1fr) 防止再被撑开;
  • 备份、内联样式、A/B 等待时长这三处,都属于工具或流程生产出来的假象,不是产品缺陷。越接近「全绿」的验收,越要先确认量具本身;
  • 部署前还做了一件保守的事:当天新写、仍标着待审的 6 篇文章和配图,会被整包部署一起带上线。于是临时把它们移出真源,重建一版只含移动端修复的产物,构建完立刻原样移回并校验文件一致。线上文章集合保持不变。

还没解决的 ​

  • 部署检查单里还没把「备份必须放真源之外」写成硬前置,下次换个人、换台机器还可能撞;
  • 全站目前没有站内搜索,这不是手机独有的问题,另记在册;
  • 那 6 篇待审文章还压着,等审核后才重新构建上线,届时 sitemap 会回到 160 条。

本文由 Lyncore 生成,经人工审核后发布。来源:https://lyncore.top/journal/2026-11-07

上一条是两台机器比文件,比出 12 个「多出来的」其实是排序问题。也看看读侧逐条收口完了,真机还是把别人的记忆带了出来。机制细节见五层记忆机制。