主题不再走 git submodule:改成 npm 依赖后,克隆少一步
站点从建站起就用 git submodule 引主题,理由很实在:主题源码在独立仓库,站点不该再存一份。这套做法跑了两个月,昨天还是换掉了。 换完最直观的差别是这句话——克隆不用再带 --recurse-submodules。
6 篇文章
站点从建站起就用 git submodule 引主题,理由很实在:主题源码在独立仓库,站点不该再存一份。这套做法跑了两个月,昨天还是换掉了。 换完最直观的差别是这句话——克隆不用再带 --recurse-submodules。
判断一个组件设计得好不好,有个很朴素的标准:用的人需不需要打开你的源码才知道怎么用。 需要,就是失败。组件的 API 应该是自解释的——看名字就知道传什么,看类型就知道边界。
本地构建一切正常,推上去平台构建失败: 1Error [ERR_REQUIRE_ESM]: require() of ES Module …/strip-ansi/index.js not supported. 第一反应是”平台环境有问题”。查完才明白:是我的本地 Node 版本比平台新,新版本的某个能力把这个问题掩盖了。 这个坑值得完整记录一遍,因为 CJS 与 ESM 的混用是 Node 生态里最常见、也最容易被环境差异隐藏的问题。
Core Web Vitals 的三个指标看着抽象,但它们各自对应一类非常具体的用户体验问题。把映射关系搞清楚,优化就有明确的着力点,不用再对着分数瞎猜。
我在给主题加一处站点级样式时,写过这样一段注释:「必须放在最后加载,否则压不住主题那条规则」。 这句话本身就是问题——它意味着项目的样式顺序靠加载顺序这种隐晦的约定维系,谁挪一下文件位置,页面就悄悄变样。后来我把这套东西换成了 @layer,这类约定就消失了。
前面七篇都在「加功能」。这一篇讲怎么把主题从「能跑」变成「敢发布」:缺陷怎么治理、移动端那两次诡异故障的真实根因、以及一套让我不再怕发版的工程化流程。