使用TortoiseGit向GitHub推送代码遇SSL版本错误如何解决？

• 检查远程仓库URL配置
  右键本地目录 → TortoiseGit → Settings → Git → Remote，确认远程仓库URL格式。若当前用HTTPS格式（https://github.com/用户名/仓库名.git），可尝试切换为SSH格式（git@github.com:用户名/仓库名.git），切换前需确保本地已生成SSH密钥并添加至GitHub账户。

• 强制指定Git使用的SSL版本
  右键本地目录 → Git Bash Here，执行以下命令强制使用TLSv1.2版本（GitHub兼容的安全SSL版本）：

  # 全局配置，对所有仓库生效
  git config --global http.sslVersion TLSv1.2
  # 仅对当前仓库生效
  git config http.sslVersion TLSv1.2
  

  若只是临时测试，可临时禁用SSL验证（不推荐长期使用）：

  git config --global http.sslVerify false
  

• 更新TortoiseGit和Git环境

  • 打开TortoiseGit → Help → Check for Updates，更新至最新版本，新版通常会集成更新的OpenSSL库，解决版本兼容问题。
  • 同时确认系统中的Git环境为最新版，TortoiseGit依赖本地Git环境，更新Git也能同步更新其内置的SSL组件。

• 排查代理设置干扰

  • 右键本地目录 → TortoiseGit → Settings → Network，检查是否配置了代理，若有可先关闭代理再尝试推送。
  • 也可在Git Bash中查看并清除全局代理配置：

    # 查看当前代理配置
    git config --global --get http.proxy
    git config --global --get https.proxy
    # 清除代理配置
    git config --global --unset http.proxy
    git config --global --unset https.proxy
    

• 更新系统SSL根证书
  确保系统根证书为最新状态，Windows用户可通过Windows更新安装最新的证书包，避免因证书不兼容导致SSL握手失败。

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