样式丢失先核对类名，再怀疑缓存与权限

更新于 2026-09-07

**「CSS 完全没渲染」这类现象，排查顺序应从「当前组件用的类名」与「CSS 文件里实际存在的类名」是否对得上开始，而不是先怀疑缓存或文件权限。** 类名对不上是最高频、也最容易被跳过的根因：文件存在、import 正常、规则上千行，看起来一切都对，但组件根本不用这些选择器。

排查顺序

顺序	检查	说明
1	类名是否匹配	重写组件（如 `page.tsx`）后，CSS 若停留在旧版类名上（旧版 `grid` 卡片类 vs 新版索引页类），规则再多也全部不命中
2	编辑历史是否弄丢了样式	用脚本改写 CSS 时容易把规则插到顶部或覆盖掉主体，导致「文件在、样式没了」
3	文件权限	`-rw-------`（600）这类权限确实可能让构建进程读不到，但它是次要嫌疑，放在类名之后

反面教材：先按权限和 import 排查，得出「一切看起来正常」的结论；真正原因是改造索引页时把新样式写进了另一个文件（后又删除），而 wiki.css 从未同步到新版类名。

缓存/热更新不只是「看不到最新」，也可能让你看到不存在的中间态：dev server 的 HMR 缓存会让页面停留在上一版，于是「代码已回退」而截图仍是旧样子，双方据此互相误判（09-07 13:36 的复盘：用户以为 agent 又改错了，直接要求「回到最初状态」）。

因此判断样式是否生效，以代码为准，不以截图为唯一依据；看到的结果与刚写的代码不符时，先怀疑是中间态（刷新/重启 dev server 再确认），别急着改第三版。