Git Pull 报错「无法创建文件（无效参数）」：全面解析及解决方法

2024-03-07 17:44:30

Git Pull 报错：无法创建文件（无效参数）

简介

在将远程仓库与本地仓库同步时，Git 用户可能会遇到 "无法创建文件（无效参数）" 错误。此错误通常发生在将包含不带扩展名的文件（例如 Makefile）的仓库克隆到 Windows 机器上时。本文将详细探讨此错误的潜在原因和解决方法，帮助你顺利地同步 Git 仓库。

错误原因

该错误主要源于 Windows 文件系统处理不带扩展名文件的独特方式。与 macOS 或 Linux 等其他操作系统不同，Windows 系统可能无法识别不带扩展名的文件，从而导致 Git 无法创建这些文件。

解决方法

使用命令行 Git: 尝试使用命令行 Git 代替图形界面客户端（例如 TortoiseGit）。命令行 Git 提供了对文件操作的更精细控制，可能能够解决此问题。
检查文件权限: 确保你有在目标文件夹中创建和修改文件的权限。尝试以管理员身份运行 Git。
启用长文件名支持: 在 Windows 7 及更早版本中，需要启用长文件名支持才能处理长文件名或不带扩展名的文件。在 "控制面板" 中的 "文件夹选项" 设置中启用此功能。
使用 cygwin: cygwin 是一个 Unix 兼容的环境，可以在 Windows 上运行。它提供了更高级的文件处理功能，可以解决此问题。
修改 Git 配置: 修改 Git 配置文件（通常位于 %USERPROFILE%\.gitconfig），并在 [core] 部分添加以下行：
```
filemode = false
```
使用 UNC 路径: 尝试使用 UNC 路径（如 \\computername\share\path\to\repo）而不是驱动器字母（如 C:\path\to\repo）来克隆仓库。
更新 Git: 确保使用的是最新版本的 Git。旧版本的 Git 可能无法正确处理此问题。
排查文件冲突: 检查是否存在文件冲突。手动删除或解决冲突文件。

代码示例

# 使用命令行 Git
git clone --progress -v "https://github.com/xxxx/xxxxx.git" "C:\Data\GitHub\simility\vishesh-common"

# 启用长文件名支持
fsutil file setshortname disable

# 修改 Git 配置
git config --global core.filemode false

# 使用 UNC 路径
git clone --progress -v "\\computername\share\path\to\repo" "C:\Data\GitHub\simility\vishesh-common"