Windows 10环境下Git克隆Saleor仓库因非法路径报错怎么解决
2026-10-17
Windows 10克隆Saleor仓库路径非法报错解决方案
报错的核心原因是Windows NTFS文件系统禁止文件名中包含冒号:等特殊字符，该仓库中对应测试用例的cassette文件名直接嵌入了带冒号的URL，触发了Windows的文件命名限制，普通强制检出命令无法绕过该规则
方案1：临时关闭Git的NTFS路径校验（适合需要完整获取所有文件的场景）
- 执行不带检出的克隆命令：
git clone --no-checkout https://github.com/mirumee/saleor.git - 进入仓库目录：
cd saleor - 针对当前仓库关闭NTFS保护配置：
git config core.protectNTFS false - 可选：如果同时提示长路径错误，追加配置：
git config core.longpaths true - 执行正常检出：
git checkout master
注意：该配置仅针对当前仓库生效，不要全局修改该配置，避免恶意构造的文件名触发Windows系统安全风险；检出后带冒号的文件无法在Windows资源管理器中直接打开/删除，需通过Git命令操作
方案2：稀疏检出排除违规文件目录（适合不需要运行该部分测试的场景，更稳妥）
- 执行不带检出的克隆命令：
git clone --no-checkout https://github.com/mirumee/saleor.git - 进入仓库目录：
cd saleor - 开启稀疏检出功能：
git config core.sparseCheckout true - 编辑仓库目录下
.git/info/sparse-checkout文件，添加如下内容，精准排除违规目录：/* !/saleor/graphql/core/tests/cassettes/ - 执行检出操作：
git checkout master
内容的提问来源于stack exchange，提问作者Megidd
相关产品推荐
相关产品推荐
