VSCode丢弃代码变更时报‘is outside repository’致命错误如何解决？

问题场景 #

通过VSCode克隆私有GitHub仓库后，尝试丢弃仓库内文件变更时触发错误，执行的Git命令及错误信息如下：

> git checkout -q -- /Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py
fatal: /Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py: '/Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py' is outside repository at '/Users/luiz/Códigos/GNSS PPP/batch_ppp'

对应的VSCode日志片段：

2024-05-27 17:06:00.866 [info] > git checkout -q -- /Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py [7ms]
2024-05-27 17:06:00.866 [info] fatal: /Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py: '/Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py' is outside repository at '/Users/luiz/Códigos/GNSS PPP/batch_ppp'
2024-05-27 17:06:00.871 [info] > git config --get commit.template [4ms]
2024-05-27 17:06:00.873 [info] > git for-each-ref --format=%(refname)%00%(upstream:short)%00%(objectname)%00%(upstream:track)%00%(upstream:remotename)%00%(upstream:remoteref) --ignore-case refs/heads/main refs/remotes/main [6ms]
2024-05-27 17:06:00.878 [info] > git status -z -uall [4ms]

核心原因 #

仓库路径中包含空格（GNSS PPP），导致Git解析路径时出现分割错误，误判目标文件位于仓库根目录之外。

解决方法 #

1. 终端手动执行丢弃命令（快速解决） #

• 打开终端，切换到仓库根目录：

  cd "/Users/luiz/Códigos/GNSS PPP/batch_ppp"
  

• 使用相对路径执行丢弃操作：

  git checkout -- ppp_processor/ppp_batch_processor.py
  

  或者用带引号的绝对路径：

  git checkout -- "/Users/luiz/Códigos/GNSS PPP/batch_ppp/ppp_processor/ppp_batch_processor.py"
  

2. 修改仓库路径（彻底规避） #

如果不想反复处理空格问题，直接修改包含空格的文件夹名称：

• 关闭VSCode及所有关联进程
• 在文件管理器中将GNSS PPP重命名为无空格的名称（如GNSS_PPP）
• 重新打开VSCode，加载修改路径后的仓库

3. 更新Git版本（适配空格解析） #

部分旧版本Git对带空格的路径支持不佳，更新到最新版本后可能自动解决该问题。

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