Git error invalid path报错问题及解决方式

 更新时间:2026年09月28日 14:30:20   作者:长行  
你是否遇到过git clone后只有.git文件夹,或者切换分支时因NTFS文件名不兼容而失败?本文为你解析原因并提供关闭NTFS保护机制的具体命令,帮你顺利拉取全部代码,解决文件显示被删除的困扰

问题情况

情形 1:使用 git clone 后,拉取的文件夹中只有 .git 文件夹,其他内容均没有拉下来。使用 git status -s 命令,可以看到所有文件都显示已被删除的状态。

情形 2:本地在切换分支时,出现如下报错信息,然后分支切换失败:

error: invalid path 'folder_1/....../name_1.txt'
error: invalid path 'folder_1/....../name_2.txt'
error: invalid path 'folder_1/....../name_3.txt'
error: invalid path 'folder_1/....../name_4.txt'

问题原因

代码中包含 NTFS 文件系统不支持的文件名。(源代码可能是在 Mac 或 Linux 等其他系统下开发的)

Git 在 Windows 下默认开启了 NTFS 保护机制,导致包含不满足 NTFS 文件名的项目无法被成功拉取,且无法切换到这些不满足 NTFS 文件名规范的文件夹中。

解决方法

关闭 NTFS 保护机制的配置,操作命令如下:

git config core.protectNTFS false

关于这个配置,Git 的描述如下:

If set to true, do not allow checkout of paths that would cause problems with the NTFS filesystem, e.g. conflict with 8.3 “short” names. Defaults to true on Windows, and false elsewhere.

开启该配置后,执行 git checkout 命令即可。

在 checkout 时会打印这些文件拉取失败的日志,但能够成功拉取其他文件:

error: unable to create file folder_1/....../name_1.txt: No such file or directory
error: unable to create file folder_1/....../name_2.txt: No such file or directory
error: unable to create file folder_1/....../name_3.txt: No such file or directory
error: unable to create file folder_1/....../name_4.txt: No such file or directory

在拉取完成后,执行 git status -s 命令后,会显示这些不满足 NTFS 文件名的文件均为被删除的状态。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • IDEA/WebStorm/Pycharm鼠标滚轮ctrl+滚轮-调节缩放字体大小

    IDEA/WebStorm/Pycharm鼠标滚轮ctrl+滚轮-调节缩放字体大小

    很多朋友不清楚IDEA/WebStorm/Pycharm鼠标滚轮ctrl+滚轮-调节缩放字体大小的,下面我以idea开发工具为例给大家通过截图一步步展示操作方法,需要的朋友可以参考下
    2021-05-05
  • 如何在Unity中使用VR暴风魔镜蓝牙手柄

    如何在Unity中使用VR暴风魔镜蓝牙手柄

    鉴于某些手机在使用大朋SDK以及谷歌SDK时会出现神器的小屏现象(比如某想的)故为了能够最大程度的兼容更多的手机,决定使用暴风魔镜的SDK。废话不多说直接将使用暴风魔镜SDK时遇到的问题以及解决方案简单的罗列一下
    2021-09-09
  • 高性能WEB开发(5) 减少请求,响应的数据量

    高性能WEB开发(5) 减少请求,响应的数据量

    上一篇中我们说到了 如何减少请求数,这次说说如何减少请求、响应的数据量(即在网络中传输的数据量),减少传输的数据量不仅仅可以加快页面加载速度,更可以节约服务器带宽,为你剩不少钱(好像很多机房托管都是按流量算钱的)。
    2010-05-05
  • Git报错error:pathspec‘XXX‘did not match any file(s) known to git问题及解决过程

    Git报错error:pathspec‘XXX‘did not match any&nbs

    这篇文章主要介绍了Git报错error:pathspec‘XXX‘did not match any file(s) known to git问题及解决过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-04-04
  • 基于webstorm卡顿问题的2种解决方法

    基于webstorm卡顿问题的2种解决方法

    下面小编就为大家分享一篇使用2种方法解决webstorm卡顿的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2017-11-11
  • Geohash的原理、算法和具体应用探究

    Geohash的原理、算法和具体应用探究

    这篇文章主要介绍了Geohash的原理、算法和具体应用探究,Geohash可以实现当前手机应用中的查找附近的人功能,需要的朋友可以参考下
    2014-07-07
  • vscode配置leetcode插件并解决无法登录问题(图文详解)

    vscode配置leetcode插件并解决无法登录问题(图文详解)

    这篇文章主要介绍了vscode配置leetcode插件并解决无法登录问题,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-06-06
  • 使用VSCode 创建一个插件

    使用VSCode 创建一个插件

    相信大家对vscode应该都不陌生,VSCode是微软出的一款轻量级代码编辑器,免费而且功能强大,以功能强大、提示友好、不错的性能和颜值俘获了大量开发者的青睐,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。
    2020-01-01
  • vscode使用editorconfig插件以及.editorconfig配置文件说明详解

    vscode使用editorconfig插件以及.editorconfig配置文件说明详解

    这篇文章主要介绍了vscode使用editorconfig插件以及.editorconfig配置文件说明详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-04-04
  • 关于页面刷新,事件重复提交的方法分享

    关于页面刷新,事件重复提交的方法分享

    在处理页面事件时,我们会经常会碰到这样的情况:当我们在提交一项页面表单时,在提交成功后,当我们试图按F5刷新页面时,数据会再次的被重复提交
    2012-10-10

最新评论