需要 SSH 方式克隆仓库的完整、分步、可直接照着做的操作方法,我会从「生成 SSH 密钥」到「验证克隆成功」一步步讲,每个步骤都标注关键注意事项,确保新手也能一次搞定。
bash
运行
bash
运行
bash
运行
bash
运行
前提确认
先关闭 Git Bash 中之前的代理配置(避免干扰 SSH 连接):bash
运行
# 清空 HTTPS 代理配置(SSH 不需要代理)
git config --global --unset http.proxy
git config --global --unset https.proxy
完整 SSH 克隆操作步骤
步骤 1:生成本地 SSH 密钥(Git Bash 中执行)
- 打开 Git Bash,输入以下命令(替换成你的 GitHub 注册邮箱,必须和账号一致):
bash
运行ssh-keygen -t rsa -C "你的GitHub邮箱@xxx.com" - 执行后会出现以下提示,全部按回车即可(新手无需自定义):
- 提示 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:→ 回车(确认无密码)。
- 提示 1:
- 执行成功后,会在
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 账号
- 登录 GitHub 官网(https://github.com),点击右上角头像 → 选择「Settings」(设置);
- 在左侧导航栏找到「SSH and GPG keys」(SSH 和 GPG 密钥),点击进入;
- 点击右上角「New SSH key」(新建 SSH 密钥);
- 填写密钥信息:
- 「Title」:随便填(比如「Windows Git Bash」,方便识别);
- 「Key」:粘贴刚才复制的公钥内容(确保完整,不要有多余换行);
- 点击「Add SSH key」(添加 SSH 密钥);
- 验证:GitHub 会要求输入你的账号密码,输入后确认,公钥就添加成功了。
步骤 4:测试 SSH 连接(关键!确保能连通 GitHub)
回到 Git Bash,执行以下命令测试:bash
运行
ssh -T git@github.com
- 首次执行会提示:
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并回车; - 若输出以下内容,说明 SSH 连接成功:
plaintextHi 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
- 执行成功后,会显示:
plaintextCloning 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文件夹,克隆完成。
常见问题排查
- 执行
ssh -T git@github.com提示「Permission denied (publickey)」:- 原因:公钥未正确添加到 GitHub,或公钥复制不完整;
- 解决:重新复制
id_rsa.pub内容(确保无截断),在 GitHub 上删除旧密钥,重新添加。
- 克隆时提示「Could not resolve host: github.com」:
- 原因:SSH 连接仍受网络 / 代理影响;
- 解决:确保代理软件已连接节点,或切换一个能访问 GitHub 的节点。
- 找不到
id_rsa.pub文件:- 原因:步骤 1 中命令执行失败,或路径错误;
- 解决:重新执行
ssh-keygen命令,执行后用ls ~/.ssh查看是否有id_rsa.pub。
总结
- SSH 克隆核心步骤:生成密钥 → 复制公钥到 GitHub → 测试连接 → 执行 SSH 克隆;
- 关键注意点:公钥必须和 GitHub 邮箱一致、复制时不要漏字符、测试连接成功后再克隆;
- SSH 方式彻底避开 HTTPS 的 SSL/TLS 握手问题,后续推送 / 拉取代码也无需输入密码,是长期最优方案。
声明:本文网友投稿,观点仅代表作者本人,不代表鲁班SEO赞同其观点或证实其描述。
