Git克隆仓库时抛出“Failed to load library 'libcurl-4.dll'”错误的原因

问题概况 #

• 执行克隆命令：

  git clone https://github.com/Charley2012/CHMS.git D:\homes\charley\编程\编程\C\CHMS\CHMS.git
  

  cmd和Git Bash均返回错误：fatal: failed to load library 'libcurl-4.dll'
• 重装Git 2.41.0后问题未解决，克隆任意GitHub仓库都触发相同错误
• GitHub Desktop可正常完成克隆操作，当前环境为Windows 10，Git安装路径为D:\homes\charley\编程\编程\DevTools\Git

解决方法 #

• 调整系统PATH环境变量
  确保Git的bin目录（D:\homes\charley\编程\编程\DevTools\Git\bin）被添加到系统PATH的最前端，而不是仅添加cmd目录。libcurl-4.dll默认存放在bin目录下，PATH未包含该路径会导致Git找不到依赖库。操作：右键“此电脑”→属性→高级系统设置→环境变量→系统变量→编辑PATH→添加上述路径并上移到顶部→重启终端生效。

• 修复Git安装目录权限
  右键Git安装根目录（D:\homes\charley\编程\编程\DevTools\Git）→属性→安全→确认当前用户拥有“完全控制”权限，权限不足可能导致动态链接库无法加载。

• 替换libcurl-4.dll文件
  从GitHub Desktop的安装目录中找到可用的libcurl-4.dll（路径通常为C:\Users\<你的用户名>\AppData\Local\GitHubDesktop\app-<版本号>\resources\app\git\usr\bin），复制到Git安装目录的bin文件夹中（先备份原文件再覆盖）。GitHub Desktop能正常工作，说明它的该库文件是完好的。

• 切换Git的SSL后端
  在Git Bash中执行以下命令，让Git使用Windows系统自带的SSL通道，绕过libcurl依赖问题：

  git config --global http.sslBackend schannel
  

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