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 worktreepnpm 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 compile0 错。
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 是唯一真相。