跳转至

ISSUE-0230 brand.tsx 漏入库(Icon? 第三案)

病灶

.gitignore:71 的 Icon?(macOS Finder Icon\r 垃圾文件通配)在大小写不敏感 文件系统(macOS 默认)上把 src/components/icons/ 目录也匹配掉了。目录被 忽略 ⇒ 后续新增文件静默不进库:

  • 第一案(注释在案):src/public/icon/128.png,5 处生产代码引用,clone 后 wxt prepare 类型缺失 tsc 报错;
  • 第三案(本案):src/components/icons/brand.tsx(v0.16.58 MUI→shadcn 迁移 配套,被 data-view.tsx/cell-renderers.tsx import),自创建起从未进库—— fresh clone / git worktree pnpm compile 必炸,主仓能跑只因文件躺在本地 磁盘。2026-10-03 建 L1 worktree 时实际踩中(compile 两处 Cannot find module '@/components/icons/brand')。

同族放大器:git worktree 派活链是新出现的高频 fresh-checkout 场景,该病 从「换机器才炸」升级为「每开一个 worktree 就炸」。

修法

  • .gitignore:Icon? 后补目录白名单前置 !src/components/icons/ 与 !src/public/icon/(第一案当年无显式豁免记录,这次一并显式化);
  • 收编 src/components/icons/brand.tsx 文件本体;
  • 验证:git check-ignore 双目录均不再命中;pnpm compile 0 错。

audit_grep 说明

本 issue 的防线(.gitignore 白名单)不在 scan-issue-coverage 的默认扫描根 (src/scripts/wxt.config.ts/package.json)内,无法用该闸表达——防线以本文档 叙述为准,新增 ignore 规则时人工 git check-ignore -v 验证的纪律见元教训。

元教训

大小写不敏感文件系统上,无斜杠锚定的通配模式(Icon?)会按「任意层级目录 名」匹配——新增 ignore 规则时必须 git check-ignore -v 验证不会误伤源码 目录;「主仓能跑」不等于「库里完整」,worktree/clone 是唯一真相。