Windows下Git误将目录识别为文件的问题求助

问题分析 #

你遇到的是Git把目标目录识别成了gitlink（子模块链接），而非普通目录，所以会显示modified: public/js/phoneme-synthesis (untracked content)，且常规的add/restore操作无法生效。

解决步骤 #

第一步：确认是否为gitlink #

执行以下命令查看目录的Git记录模式：

git ls-files -s public/js/phoneme-synthesis

如果输出包含160000（gitlink的专属模式位），则可以确定是gitlink问题。

第二步：移除gitlink并将目录作为普通目录追踪 #

1. 移除Git中记录的gitlink（不会删除本地文件）：

   git rm --cached public/js/phoneme-synthesis
   

2. 将目录内的文件加入Git追踪：

   git add public/js/phoneme-synthesis/
   

   注意末尾的斜杠/，确保Git识别为目录而非单个文件
3. 提交更改：

   git commit -m "修复gitlink问题，将phoneme-synthesis作为普通目录追踪"
   

若为误创建的子模块，需彻底清理子模块记录 #

如果该目录曾被作为子模块初始化，还需要清理子模块的缓存文件：

1. 取消子模块关联：

   git submodule deinit -f public/js/phoneme-synthesis
   

2. 删除Git本地缓存的子模块数据：

   rm -rf .git/modules/public/js/phoneme-synthesis
   

3. 移除gitlink记录：

   git rm -f public/js/phoneme-synthesis
   

4. 重新添加目录文件并提交（同第二步的2、3）

额外排查：Windows文件系统大小写问题 #

Windows默认不区分文件名大小写，若Git记录的目录名和本地实际目录名大小写不一致，也可能导致识别异常：

• 检查本地目录名与Git记录是否一致，必要时修改统一
• 若需要开启Git大小写敏感（谨慎操作，可能影响其他文件）：

  git config core.ignorecase false
  

内容的提问来源于stack exchange，提问作者Hacker