在VS Code处理GitHub仓库时遇Git错误：无法读取实为目录的'~'

在VS Code操作GitHub仓库时，会触发以下两个错误：

git) unable to read file ~ that is actually a directory
error: Unable to open 'src (Working Tree)': Unable to read file '~' that is actually a directory

解决步骤： #

• 排查本地仓库中的~目录：打开终端进入仓库根目录，执行ls -la查看是否存在名为~的目录。Git默认将~解析为用户主目录缩写，若它是实际存在的物理目录，会引发识别冲突。
• 处理冲突目录：
  • 若该目录是误创建的，直接重命名或删除：

    # 重命名示例
    mv ~ temp_backup
    # 删除（请确认目录无重要文件后执行）
    rm -rf ~
    

  • 若该目录是需要保留的临时文件目录，将其添加到.gitignore中阻止Git追踪：

    # 在.gitignore文件中添加
    ~/
    

• 刷新VS Code的Git状态：完成操作后，点击VS Code左侧源代码管理面板的刷新图标，或重启VS Code，让Git重新扫描仓库文件结构。

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