用途:解决 TypeScript 诊断 1261(Already_included_file_name_0_differs_from_file_name_1_only_in_casing),即同一文件在导入路径与 include/program 中出现仅大小写不同的两种拼写。常见原因是 git 跟踪 fooBar.ts 而代码导入 ./FooBar,或仅改大小写的重命名未同步索引。
主要能力:定位两种大小写拼写、确定规范名称(以导入使用且全仓库一致的 Pascal/camel 为准)、在大小写不敏感文件系统(macOS 默认、Windows)上完成仅改大小写的重命名。
使用方式:在大小写不敏感文件系统上,仅改大小写的重命名需借助中间名,使 git 与文件系统都更新: cd path/to/dir git mv WrongCaseName.ts _tmp_rename.ts git mv _tmp_rename.ts RightCaseName.ts 然后运行 npm run compile。单次 git mv a.ts A.ts 常因两路径解析相同而无效或失败,两步移动更可靠。若处理索引,可用 git rm --cached <wrong-cased-path> 移除错误大小写的索引项,但仍需在磁盘上以正确大小写放置内容。
验证:运行 npm run compile;用 git ls-files path/to/dir | grep -i <basename> 确认只有一行且大小写与导入一致。
检查清单:读取 TS1261 报错行识别两种拼写;选择与现有导入一致的拼写;在大小写不敏感文件系统上做仅改大小写的两步 git mv;重新编译。
限制:资料未提供更多平台、版本或自动化支持信息。