1. 首页 > 编程开发 > github

直接用 SSH 方式克隆(彻底避开 HTTPS/SSL 问题) 给出我详细的操作方法

需要 SSH 方式克隆仓库的完整、分步、可直接照着做的操作方法,我会从「生成 SSH 密钥」到「验证克隆成功」一步步讲,每个步骤都标注关键注意事项,确保新手也能一次搞定。

前提确认

先关闭 Git Bash 中之前的代理配置(避免干扰 SSH 连接):
bash
运行
# 清空 HTTPS 代理配置(SSH 不需要代理)
git config --global --unset http.proxy
git config --global --unset https.proxy

完整 SSH 克隆操作步骤

步骤 1:生成本地 SSH 密钥(Git Bash 中执行)

  1. 打开 Git Bash,输入以下命令(替换成你的 GitHub 注册邮箱,必须和账号一致):
    bash
    运行
    ssh-keygen -t rsa -C "你的GitHub邮箱@xxx.com"
    
  2. 执行后会出现以下提示,全部按回车即可(新手无需自定义):
    • 提示 1:Enter file in which to save the key (/c/Users/EDY/.ssh/id_rsa): → 回车(保存到默认路径);
    • 提示 2:Enter passphrase (empty for no passphrase): → 回车(无需设置密钥密码,简化操作);
    • 提示 3:Enter same passphrase again: → 回车(确认无密码)。
  3. 执行成功后,会在 C:\Users\EDY\.ssh 目录下生成两个文件:
    • id_rsa:私钥(重要!不要泄露、不要删除);
    • id_rsa.pub:公钥(需要复制到 GitHub)。

步骤 2:复制 SSH 公钥内容

在 Git Bash 中执行以下命令,输出公钥内容:
bash
运行
cat ~/.ssh/id_rsa.pub
  • 输出内容格式类似:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...(中间一串字符)... 你的GitHub邮箱@xxx.com
  • 全选复制这段内容(从 ssh-rsa 开头到邮箱结尾,不要漏字符、不要多空格)。

步骤 3:将公钥添加到 GitHub 账号

  1. 登录 GitHub 官网(https://github.com),点击右上角头像 → 选择「Settings」(设置);
  2. 在左侧导航栏找到「SSH and GPG keys」(SSH 和 GPG 密钥),点击进入;
  3. 点击右上角「New SSH key」(新建 SSH 密钥);
  4. 填写密钥信息:
    • 「Title」:随便填(比如「Windows Git Bash」,方便识别);
    • 「Key」:粘贴刚才复制的公钥内容(确保完整,不要有多余换行);
  5. 点击「Add SSH key」(添加 SSH 密钥);
  6. 验证:GitHub 会要求输入你的账号密码,输入后确认,公钥就添加成功了。

步骤 4:测试 SSH 连接(关键!确保能连通 GitHub)

回到 Git Bash,执行以下命令测试:
bash
运行
ssh -T git@github.com
  1. 首次执行会提示:The authenticity of host 'github.com (xx.xx.xx.xx)' can't be established... Are you sure you want to continue connecting (yes/no/[fingerprint])? → 输入 yes 并回车;
  2. 若输出以下内容,说明 SSH 连接成功:
    plaintext
    Hi beylze! You've successfully authenticated, but GitHub does not provide shell access.
    
    • 若提示「Permission denied (publickey)」,说明公钥添加错误,回到步骤 2-3 重新检查。

步骤 5:用 SSH 地址克隆 AiPPT 仓库

在 Git Bash 中切换到你想克隆的目录(比如桌面),执行克隆命令:
bash
运行
# 先切换到目标目录(比如桌面,可替换成你想要的路径)
cd /c/Users/EDY/Desktop/工作/脚本开发

# 执行 SSH 克隆(地址是 git@ 开头,不是 https:// 开头)
git clone git@github.com:beylze/AiPPT.git
  • 执行成功后,会显示:
    plaintext
    Cloning into 'AiPPT'...
    remote: Enumerating objects: xx, done.
    remote: Counting objects: 100% (xx/xx), done.
    remote: Compressing objects: 100% (xx/xx), done.
    Receiving objects: 100% (xx/xx), xx.xx KiB | xx.xx MiB/s, done.
    Resolving deltas: 100% (xx/xx), done.
    
  • 此时在 C:\Users\EDY\Desktop\工作\脚本开发 目录下会出现 AiPPT 文件夹,克隆完成。

常见问题排查

  1. 执行 ssh -T git@github.com 提示「Permission denied (publickey)」:
    • 原因:公钥未正确添加到 GitHub,或公钥复制不完整;
    • 解决:重新复制 id_rsa.pub 内容(确保无截断),在 GitHub 上删除旧密钥,重新添加。
  2. 克隆时提示「Could not resolve host: github.com」:
    • 原因:SSH 连接仍受网络 / 代理影响;
    • 解决:确保代理软件已连接节点,或切换一个能访问 GitHub 的节点。
  3. 找不到 id_rsa.pub 文件:
    • 原因:步骤 1 中命令执行失败,或路径错误;
    • 解决:重新执行 ssh-keygen 命令,执行后用 ls ~/.ssh 查看是否有 id_rsa.pub

总结

  1. SSH 克隆核心步骤:生成密钥 → 复制公钥到 GitHub → 测试连接 → 执行 SSH 克隆;
  2. 关键注意点:公钥必须和 GitHub 邮箱一致、复制时不要漏字符、测试连接成功后再克隆;
  3. SSH 方式彻底避开 HTTPS 的 SSL/TLS 握手问题,后续推送 / 拉取代码也无需输入密码,是长期最优方案。

声明:本文网友投稿,观点仅代表作者本人,不代表鲁班SEO赞同其观点或证实其描述。

联系我们

在线咨询:点击这里给我发消息

微信号:

工作日:9:30-18:30,节假日休息