上传项目到Github详细步骤(ssh)。这两年被问得最多的不是怎么commit而是怎么把我这一堆代码安全地推到GitHub上。很多教程让用HTTPS输个用户名密码就完事但等你换了电脑、改了密码、或者想在服务器上自动拉代码的时候就知道SSH的好了。这篇东西不扯废话从SSH密钥的原理讲到最后一脚push把每一步为什么这么做、容易在哪翻车都交代清楚照着敲就行。1. 为什么我坚持用SSH传GitHub项目免密、稳定、一次配置长期有效先用最简单的话说清楚SSH在这里扮演什么角色。GitHub支持两种主要的上传协议——HTTPS和SSH。HTTPS方式下你每次push/pull都要验证身份虽然可以配置credential helper记住密码但碰上公司电脑换了、Token过期、两步验证开启的年代HTTPS的体验真的很糟。SSH方式则是靠一对密钥来证明你是你私钥留在本地公钥交给GitHub握手的时候自动完成身份认证全程不用输任何密码。为什么推荐SSH而不是HTTPS站在一个常年跟远程仓库打交道的开发者角度有三个理由足够了长连接更稳。SSH基于TCP的22端口在持续push大项目时不容易被中间代理打断。免密操作。配置好之后clone、push、pull都是静默完成特别适合写脚本批量操作、在服务器上部署代码。安全边界清晰。私钥不出本地机器泄露风险比反复输入账号密码低得多。所以本文的核心路线就一条在本地生成密钥对 → 把公钥粘贴到GitHub → 本地Git远程地址改成SSH格式 → push代码。这套流程同时适用于Windows、macOS、Linux三家系统命令几乎通用。1.1 你需要提前准备的东西开工前检查一下自己手头的原料缺了哪个后面都会卡壳Git客户端。命令git --version能出来版本号就行。没有的话去官网下载安装Windows装完会自带Git Bash。GitHub账号。这个不用多说注册好邮箱最好验证过。一个本地项目。不管是你刚写完的代码文件夹还是从别处拷来的项目目录都行。本机能连上外网。注意是能正常访问GitHub的网络环境。如果网页都打不开先解决网络连通性问题这不是SSH配置能解决的别再纠结密钥格式对不对。这几样齐了就可以放心往下走了。2. 生成SSH密钥对ssh-keygen的每一个参数都值得你搞清楚密钥对是整个SSH方案的基石。很多人执行一句ssh-keygen -t rsa就草草收场其实这里面的学问不小尤其要搞清楚你的GitHub账户到底需要什么样的密钥。2.1 标准生成命令与参数解读打开终端Windows用Git BashmacOS/Linux直接用系统终端输入ssh-keygen -t ed25519 -C your_emailexample.com -f ~/.ssh/github_id这里我给的是推荐参数组合逐个说-t ed25519指定密钥算法类型。以前教程里全是rsa但ED25519更安全、密钥更短、生成更快GitHub早已支持。除非你要兼容非常老旧的服务器否则首选ED25519。-C your_emailexample.com这个注释只是给人看的标签方便你日后区分密钥。写你的GitHub注册邮箱就行但注意它不参与任何加密计算纯备注。-f ~/.ssh/github_id指定密钥文件存放的路径和名字。这里我故意不用默认的id_ed25519后面讲多账号管理你就知道这个习惯有多香。回车之后终端会让你设置 passphrase口令。这里可以留空直接回车也可以设一个。个人建议个人电脑可以留空公司电脑或者你特别在意安全的场景设一个口令更稳。但设了口令每次用密钥都要输一次口令想省事可以用ssh-add把它加进agent里后面细说。生成完成~/.ssh目录下会出现两个文件github_id # 私钥死也不能泄露 github_id.pub # 公钥这个就是要交给GitHub的2.2 查看公钥内容的方法复制公钥内容用下面哪个命令都行cat ~/.ssh/github_id.pub # 或者 clip ~/.ssh/github_id.pub # Windows Git Bash专用直接进剪贴板输出的是一段ssh-ed25519 AAAA...你的邮箱格式的字符串注意别把私钥内容发出去。有些朋友会不小心cat github_id没有.pub后缀那等于把家门钥匙拍了照发朋友圈后患无穷。2.3 旧RSA密钥要不要处理如果你电脑里已经有id_rsa那一套又懒得重新生成其实也可以直接用。GitHub对RSA密钥的支持没有取消但2048位以上的RSA才够安全。已经用旧密钥连接的建议趁这次机会重新生成ED25519并替换顺便把GitHub网页上废弃的公钥删掉养成密钥卫生习惯。3. 把公钥登记到GitHub账户网页端操作的完整路径密钥生成好了下一步就是让GitHub认得这把公钥。这一步操作在网页上但很多人第一次会找半天入口我直接给你画条路线。3.1 操作路径与填写细节登录GitHub点右上角头像 →Settings。左侧菜单里找SSH and GPG keys在Access分类下面。点绿色按钮New SSH key。Title栏随便填但建议填这台机器的名字用途比如Windows-Laptop-2024、Company-Mac。以后密钥多了这个title是你唯一的辨认依据。Key type选Authentication Key这是默认项用来做Git操作认证。Key栏把你github_id.pub文件的完整内容粘贴进去别漏掉末尾的邮箱部分也别自己手打换行直接粘贴就是对的。点Add SSH key会让你输一次GitHub密码确认完事。3.2 在同一台电脑管理多个GitHub账号的注册技巧如果你生活里有两个GitHub号比如一个工作号一个个人号就得注意了。一个公钥不能同时添加到两个不同的GitHub账号否则GitHub会报错Key already in use。解决方案是生成两个不同的密钥文件比如github_work和github_personal在~/.ssh/config里配置域名映射这部分我放到第五章专门讲。3.3 验证密钥是否被GitHub接受注册完别急着push先测一把连通性ssh -T gitgithub.com第一次连接会看到类似这样的提示The authenticity of host github.com (IP) cant be established. ED25519 key fingerprint is SHA256:DiY3wvvWj4rZPwJxYesd9W7pZc2YyQzP3w7oZpMk. Are you sure you want to continue connecting (yes/no)?这是SSH在问你认不认识这台主机输入yes回车它会把GitHub的指纹写进~/.ssh/known_hosts以后就不会再问了。如果配置正确最后你会看到Hi 你的用户名! Youve successfully authenticated, but GitHub does not provide shell access.看到这段话说明认证成功可以push了。如果提示Permission denied (publickey)就去查密钥路径、是否添加到了ssh-agent、GitHub网页上是不是真的保存了这三板斧能解决90%的认证失败。4. 把本地项目初始化并关联到GitHub远程仓库密钥通了接下来才是上传的正题。整个流程分两半本地Git仓库的初始化与提交远程仓库的创建与关联。4.1 初始化本地仓库并完成第一次提交在项目根目录打开终端执行git init这个命令会在当前目录下生成一个.git隐藏文件夹也就是把普通目录变成Git仓库。这个命令执行一次就行别在子目录反复执行否则会出现嵌套仓库的怪问题。接着把项目里的所有文件加入暂存区git add .不要小看这一步.表示把当前目录下所有未被忽略的文件都加进去。如果你项目里有node_modules、target、.idea这种不想上传的目录建议先写一个.gitignore再执行add不然会把一堆垃圾文件推上去体验极差。然后提交一次git commit -m Initial commit-m后面是这次提交的说明格式随你但别空着。有些机器首次提交会提示要设置user.name和user.email用下面命令设置全局值git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的邮箱建议用GitHub账号绑定的邮箱这样提交记录才能跟你的GitHub头像挂上钩。4.2 在GitHub网页上创建远程仓库登录GitHub右上角那个号 →New repository。Repository name 填项目名一般和本地文件夹同名描述可选。Visibility 选 Public 还是 Private 看你自己Public是任何人都能看Private只有你和你授权的人能看新手建议先Private反悔的成本低。这里有一个容易被带偏的点创建完仓库后GitHub会显示一段初始化命令比如git remote add origin...但你要是已经在本地git init过了就不要照抄它的git init那一步你只需要那个git remote add命令而已。4.3 关联远程地址的两种写法对比GitHub给每个仓库都提供两种远程地址在仓库首页的Code绿色按钮里可以切换# HTTPS形式 https://github.com/你的用户名/你的仓库名.git # SSH形式我们用的 gitgithub.com:你的用户名/你的仓库名.git注意区别SSH地址的开头是gitgithub.com:冒号后面才是用户名和仓库名不要复制错。用命令关联git remote add origin gitgithub.com:你的用户名/你的仓库名.git关联之后可以用git remote -v检查会列出fetch和push两个地址。如果之前关联过错误地址想改掉就用git remote set-url origin 新地址。5. 多账号与SSH config配置一套SSH秘钥吃遍所有Git托管平台很多人以为SSH和GitHub绑定是一对一的关系其实你可以把同一套密钥配到GitLab、Gitee、公司私有Git服务器上也可以给每个平台配不同的密钥。这背后就是~/.ssh/config文件在起作用。5.1 为什么要配置config文件默认情况下SSH会用~/.ssh/id_ed25519或者你通过agent指定的私钥去连接GitHub。但如果你为了多账号生成了好几个密钥比如github_work、github_personal、gitlab_companySSH不知道哪个域名用哪个密钥就需要config文件来指路。5.2 config文件的标准写法在~/.ssh/config文件没有就新建里写上Host github.com HostName github.com User git IdentityFile ~/.ssh/github_id Host github-work HostName github.com User git IdentityFile ~/.ssh/github_work Host gitlab.com HostName gitlab.com User git IdentityFile ~/.ssh/gitlab_company看到这个Host github-work的写法了吗这是一个别名意味着你在克隆工作仓库的时候需要把远程地址写成gitgithub-work:你的工作账号/仓库名.git而不是默认的gitgithub.com:...。SSH会根据这个别名去匹配对应的私钥。这样在同一个目录下你可以同时跟个人GitHub仓库和工作GitHub仓库打交道互不干扰。5.3 ssh-agent与passphrase的配合前面说过如果私钥设置了passphrase每次连接都会要求输入。不想反复敲的话可以启动SSH代理eval $(ssh-agent -s) ssh-add ~/.ssh/github_id第一次执行ssh-add会提示输入passphrase之后在当前终端会话里就不用了。macOS还可以用ssh-add --apple-use-keychain把密钥写进系统钥匙串重启电脑也免输。这也解释了为什么我一直强调用-f参数指定非默认文件名如果所有密钥都叫id_ed25519多账号之间会互相覆盖光凭文件名根本没法区分。6. 执行Push推送首次连接的指纹确认与常见错误处置方向都指好了真正把代码推上去靠的是git push。这一步是新手翻车重灾区我把常见的报错和原因一次性讲透。6.1 标准推送命令首次向远程推送需要指定上游分支git push -u origin main-u是--set-upstream的简写意思是把本地main分支和远程origin/main关联起来。以后在这个分支上直接git push就行不用再带参数。origin是你的远程仓库别名前面git remote add时起的名字。main是你的本地分支名。如果你的Git默认分支叫master对应改成master就行。6.2 首次连接的主机指纹确认如果你前面没单独执行过ssh -T gitgithub.compush时SSH会先弹出来一段主机指纹确认和第三章提到的那个提示一模一样。这时输入yes回车即可它会把GitHub的host key存到known_hosts。千万别在这里输no否则直接连接中止。更不要慌慌张张按CtrlC虽然也没啥破坏但你会被反复要求确认。6.3 经典错误Permission denied (publickey)这个错误基本等于你的私钥没被SSH用在这次连接上。按这个顺序排查ssh -T gitgithub.com是否输出成功信息失败的话回到第3章的验证步骤。检查config文件里IdentityFile路径是否对文件名是不是带.pub后缀的IdentityFile必须指向私钥文件不是公钥。确认GitHub网页上SSH keys列表里有没有你正在用的这把公钥。Windows用户常见问题Git Bash不同会话里ssh-agent没启动导致私钥没被加载。每次开新窗口重新执行ssh-add ~/.ssh/github_id。6.4 经典错误Repository not found这个报错很迷惑明明仓库存在却说找不到。绝大多数原因是你当前SSH密钥对应的GitHub账号没有这个仓库的访问权限。可能性有两类仓库是私有的而密钥对的是另一个账号。仓库属于某组织而你不在该组织的成员列表里。处理方式在config里切到有权限的账号对应的Host别名修改远程地址为git别名:用户名/仓库名.git再push。6.5 远程仓库有提交导致Push被拒如果你在网页端Readme.md自动初始化过或者远程仓库里已经有了别的文件push会因为双方历史不一致被拒。这时有两个选择git pull origin main --rebase git push origin main先拉取远程最新内容放到本地最新提交的前面再推送。新手别一上来就git push -f强制覆盖强制推送是把远程历史整个换成你本地历史会把别人的提交抹掉合作项目里这么干容易被骂到怀疑人生。7. 上传完成后的收尾与日常使用建议代码推上去了不代表事情就完了。真正的日常工作里围绕SSH上传还有几个高频场景值得说说。7.1 换新电脑后怎么快速恢复换电脑最痛的不是系统安装而是把SSH密钥环境重新搭起来。推荐的做法是把旧电脑的~/.ssh目录整个备份出来github_id和github_id.pub一起拷到U盘或密码管理器。新电脑放到.ssh目录改权限Linux/macOS执行chmod 600 ~/.ssh/github_idWindows用Git Bash同样执行。不用去GitHub重新加公钥因为公钥没变直接测ssh -T gitgithub.com。千万别把私钥上传到公开仓库或聊天工具里再下载这是最危险的操作。7.2 Clone我是用SSH还是HTTPS如果只是临时拉一个别人的公开项目用HTTPS更快不用走密钥认证。但如果你要往里推送代码、或者回源拉取自己的私有项目请一定用SSH地址git clone gitgithub.com:用户名/仓库名.git一个很实用的小技巧在仓库页面可以直接选SSH下拉项复制出来的地址就是gitgithub.com:...开头直接粘贴到终端即可不用手动改。7.3 更新远程仓库地址有时候你已经用HTTPS clone下来了临时改成SSH免密用这一条git remote set-url origin gitgithub.com:用户名/仓库名.git改完可以用git remote -v验证两个URL都变成SSH格式就成功了。8. 从上传代码到正常维护一套不会出错的状态检查方法最后分享一个我用了很多年的状态自检思路很多人上传失败根本不是哪一步操作错而是不知道自己当前处于什么状态。Git是一个有状态的管理工具你要像体检一样定期检查它的状态。最常用的三个检查命令和它们解决什么问题git status # 当前工作区有没有改动有没有文件没add/commit git remote -v # 当前仓库的远程地址是什么协议对不对 git branch -vv # 当前分支和哪个远程分支关联处于领先还是落后每一条都是用来回答一个我在哪的问题。举个例子git status显示Your branch is up to date with origin/main说明本地和远程完全同步显示Your branch is ahead of origin/main by 1 commit说明本地多了一个提交需要push显示Your branch is behind说明远程有别人推送的内容需要pull。还有个值得一提的细节SSH连接正常不代表Git仓库关联正确。你可以ssh -T gitgithub.com通过认证但git push仍然失败这时候检查重点就放在git remote -v和分支关联上而不是回头去折腾密钥。根据我个人的实操体验上传项目到GitHub这件事90%的问题都集中在密钥认证失败和远程地址写错这两类上。把这套SSH流程从头到尾走一遍之后所有需要与远程仓库打交道的场景——不管是个人项目备份、开源项目贡献还是服务器自动部署——就全都顺了。你也别怕第一次push失败报错信息其实就是最好的排查指南把每条报错记下来多踩几次坑以后闭着眼都能处理。
SSH上传项目到GitHub完整指南：从密钥生成到git push免密推送
上传项目到Github详细步骤(ssh)。这两年被问得最多的不是怎么commit而是怎么把我这一堆代码安全地推到GitHub上。很多教程让用HTTPS输个用户名密码就完事但等你换了电脑、改了密码、或者想在服务器上自动拉代码的时候就知道SSH的好了。这篇东西不扯废话从SSH密钥的原理讲到最后一脚push把每一步为什么这么做、容易在哪翻车都交代清楚照着敲就行。1. 为什么我坚持用SSH传GitHub项目免密、稳定、一次配置长期有效先用最简单的话说清楚SSH在这里扮演什么角色。GitHub支持两种主要的上传协议——HTTPS和SSH。HTTPS方式下你每次push/pull都要验证身份虽然可以配置credential helper记住密码但碰上公司电脑换了、Token过期、两步验证开启的年代HTTPS的体验真的很糟。SSH方式则是靠一对密钥来证明你是你私钥留在本地公钥交给GitHub握手的时候自动完成身份认证全程不用输任何密码。为什么推荐SSH而不是HTTPS站在一个常年跟远程仓库打交道的开发者角度有三个理由足够了长连接更稳。SSH基于TCP的22端口在持续push大项目时不容易被中间代理打断。免密操作。配置好之后clone、push、pull都是静默完成特别适合写脚本批量操作、在服务器上部署代码。安全边界清晰。私钥不出本地机器泄露风险比反复输入账号密码低得多。所以本文的核心路线就一条在本地生成密钥对 → 把公钥粘贴到GitHub → 本地Git远程地址改成SSH格式 → push代码。这套流程同时适用于Windows、macOS、Linux三家系统命令几乎通用。1.1 你需要提前准备的东西开工前检查一下自己手头的原料缺了哪个后面都会卡壳Git客户端。命令git --version能出来版本号就行。没有的话去官网下载安装Windows装完会自带Git Bash。GitHub账号。这个不用多说注册好邮箱最好验证过。一个本地项目。不管是你刚写完的代码文件夹还是从别处拷来的项目目录都行。本机能连上外网。注意是能正常访问GitHub的网络环境。如果网页都打不开先解决网络连通性问题这不是SSH配置能解决的别再纠结密钥格式对不对。这几样齐了就可以放心往下走了。2. 生成SSH密钥对ssh-keygen的每一个参数都值得你搞清楚密钥对是整个SSH方案的基石。很多人执行一句ssh-keygen -t rsa就草草收场其实这里面的学问不小尤其要搞清楚你的GitHub账户到底需要什么样的密钥。2.1 标准生成命令与参数解读打开终端Windows用Git BashmacOS/Linux直接用系统终端输入ssh-keygen -t ed25519 -C your_emailexample.com -f ~/.ssh/github_id这里我给的是推荐参数组合逐个说-t ed25519指定密钥算法类型。以前教程里全是rsa但ED25519更安全、密钥更短、生成更快GitHub早已支持。除非你要兼容非常老旧的服务器否则首选ED25519。-C your_emailexample.com这个注释只是给人看的标签方便你日后区分密钥。写你的GitHub注册邮箱就行但注意它不参与任何加密计算纯备注。-f ~/.ssh/github_id指定密钥文件存放的路径和名字。这里我故意不用默认的id_ed25519后面讲多账号管理你就知道这个习惯有多香。回车之后终端会让你设置 passphrase口令。这里可以留空直接回车也可以设一个。个人建议个人电脑可以留空公司电脑或者你特别在意安全的场景设一个口令更稳。但设了口令每次用密钥都要输一次口令想省事可以用ssh-add把它加进agent里后面细说。生成完成~/.ssh目录下会出现两个文件github_id # 私钥死也不能泄露 github_id.pub # 公钥这个就是要交给GitHub的2.2 查看公钥内容的方法复制公钥内容用下面哪个命令都行cat ~/.ssh/github_id.pub # 或者 clip ~/.ssh/github_id.pub # Windows Git Bash专用直接进剪贴板输出的是一段ssh-ed25519 AAAA...你的邮箱格式的字符串注意别把私钥内容发出去。有些朋友会不小心cat github_id没有.pub后缀那等于把家门钥匙拍了照发朋友圈后患无穷。2.3 旧RSA密钥要不要处理如果你电脑里已经有id_rsa那一套又懒得重新生成其实也可以直接用。GitHub对RSA密钥的支持没有取消但2048位以上的RSA才够安全。已经用旧密钥连接的建议趁这次机会重新生成ED25519并替换顺便把GitHub网页上废弃的公钥删掉养成密钥卫生习惯。3. 把公钥登记到GitHub账户网页端操作的完整路径密钥生成好了下一步就是让GitHub认得这把公钥。这一步操作在网页上但很多人第一次会找半天入口我直接给你画条路线。3.1 操作路径与填写细节登录GitHub点右上角头像 →Settings。左侧菜单里找SSH and GPG keys在Access分类下面。点绿色按钮New SSH key。Title栏随便填但建议填这台机器的名字用途比如Windows-Laptop-2024、Company-Mac。以后密钥多了这个title是你唯一的辨认依据。Key type选Authentication Key这是默认项用来做Git操作认证。Key栏把你github_id.pub文件的完整内容粘贴进去别漏掉末尾的邮箱部分也别自己手打换行直接粘贴就是对的。点Add SSH key会让你输一次GitHub密码确认完事。3.2 在同一台电脑管理多个GitHub账号的注册技巧如果你生活里有两个GitHub号比如一个工作号一个个人号就得注意了。一个公钥不能同时添加到两个不同的GitHub账号否则GitHub会报错Key already in use。解决方案是生成两个不同的密钥文件比如github_work和github_personal在~/.ssh/config里配置域名映射这部分我放到第五章专门讲。3.3 验证密钥是否被GitHub接受注册完别急着push先测一把连通性ssh -T gitgithub.com第一次连接会看到类似这样的提示The authenticity of host github.com (IP) cant be established. ED25519 key fingerprint is SHA256:DiY3wvvWj4rZPwJxYesd9W7pZc2YyQzP3w7oZpMk. Are you sure you want to continue connecting (yes/no)?这是SSH在问你认不认识这台主机输入yes回车它会把GitHub的指纹写进~/.ssh/known_hosts以后就不会再问了。如果配置正确最后你会看到Hi 你的用户名! Youve successfully authenticated, but GitHub does not provide shell access.看到这段话说明认证成功可以push了。如果提示Permission denied (publickey)就去查密钥路径、是否添加到了ssh-agent、GitHub网页上是不是真的保存了这三板斧能解决90%的认证失败。4. 把本地项目初始化并关联到GitHub远程仓库密钥通了接下来才是上传的正题。整个流程分两半本地Git仓库的初始化与提交远程仓库的创建与关联。4.1 初始化本地仓库并完成第一次提交在项目根目录打开终端执行git init这个命令会在当前目录下生成一个.git隐藏文件夹也就是把普通目录变成Git仓库。这个命令执行一次就行别在子目录反复执行否则会出现嵌套仓库的怪问题。接着把项目里的所有文件加入暂存区git add .不要小看这一步.表示把当前目录下所有未被忽略的文件都加进去。如果你项目里有node_modules、target、.idea这种不想上传的目录建议先写一个.gitignore再执行add不然会把一堆垃圾文件推上去体验极差。然后提交一次git commit -m Initial commit-m后面是这次提交的说明格式随你但别空着。有些机器首次提交会提示要设置user.name和user.email用下面命令设置全局值git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的邮箱建议用GitHub账号绑定的邮箱这样提交记录才能跟你的GitHub头像挂上钩。4.2 在GitHub网页上创建远程仓库登录GitHub右上角那个号 →New repository。Repository name 填项目名一般和本地文件夹同名描述可选。Visibility 选 Public 还是 Private 看你自己Public是任何人都能看Private只有你和你授权的人能看新手建议先Private反悔的成本低。这里有一个容易被带偏的点创建完仓库后GitHub会显示一段初始化命令比如git remote add origin...但你要是已经在本地git init过了就不要照抄它的git init那一步你只需要那个git remote add命令而已。4.3 关联远程地址的两种写法对比GitHub给每个仓库都提供两种远程地址在仓库首页的Code绿色按钮里可以切换# HTTPS形式 https://github.com/你的用户名/你的仓库名.git # SSH形式我们用的 gitgithub.com:你的用户名/你的仓库名.git注意区别SSH地址的开头是gitgithub.com:冒号后面才是用户名和仓库名不要复制错。用命令关联git remote add origin gitgithub.com:你的用户名/你的仓库名.git关联之后可以用git remote -v检查会列出fetch和push两个地址。如果之前关联过错误地址想改掉就用git remote set-url origin 新地址。5. 多账号与SSH config配置一套SSH秘钥吃遍所有Git托管平台很多人以为SSH和GitHub绑定是一对一的关系其实你可以把同一套密钥配到GitLab、Gitee、公司私有Git服务器上也可以给每个平台配不同的密钥。这背后就是~/.ssh/config文件在起作用。5.1 为什么要配置config文件默认情况下SSH会用~/.ssh/id_ed25519或者你通过agent指定的私钥去连接GitHub。但如果你为了多账号生成了好几个密钥比如github_work、github_personal、gitlab_companySSH不知道哪个域名用哪个密钥就需要config文件来指路。5.2 config文件的标准写法在~/.ssh/config文件没有就新建里写上Host github.com HostName github.com User git IdentityFile ~/.ssh/github_id Host github-work HostName github.com User git IdentityFile ~/.ssh/github_work Host gitlab.com HostName gitlab.com User git IdentityFile ~/.ssh/gitlab_company看到这个Host github-work的写法了吗这是一个别名意味着你在克隆工作仓库的时候需要把远程地址写成gitgithub-work:你的工作账号/仓库名.git而不是默认的gitgithub.com:...。SSH会根据这个别名去匹配对应的私钥。这样在同一个目录下你可以同时跟个人GitHub仓库和工作GitHub仓库打交道互不干扰。5.3 ssh-agent与passphrase的配合前面说过如果私钥设置了passphrase每次连接都会要求输入。不想反复敲的话可以启动SSH代理eval $(ssh-agent -s) ssh-add ~/.ssh/github_id第一次执行ssh-add会提示输入passphrase之后在当前终端会话里就不用了。macOS还可以用ssh-add --apple-use-keychain把密钥写进系统钥匙串重启电脑也免输。这也解释了为什么我一直强调用-f参数指定非默认文件名如果所有密钥都叫id_ed25519多账号之间会互相覆盖光凭文件名根本没法区分。6. 执行Push推送首次连接的指纹确认与常见错误处置方向都指好了真正把代码推上去靠的是git push。这一步是新手翻车重灾区我把常见的报错和原因一次性讲透。6.1 标准推送命令首次向远程推送需要指定上游分支git push -u origin main-u是--set-upstream的简写意思是把本地main分支和远程origin/main关联起来。以后在这个分支上直接git push就行不用再带参数。origin是你的远程仓库别名前面git remote add时起的名字。main是你的本地分支名。如果你的Git默认分支叫master对应改成master就行。6.2 首次连接的主机指纹确认如果你前面没单独执行过ssh -T gitgithub.compush时SSH会先弹出来一段主机指纹确认和第三章提到的那个提示一模一样。这时输入yes回车即可它会把GitHub的host key存到known_hosts。千万别在这里输no否则直接连接中止。更不要慌慌张张按CtrlC虽然也没啥破坏但你会被反复要求确认。6.3 经典错误Permission denied (publickey)这个错误基本等于你的私钥没被SSH用在这次连接上。按这个顺序排查ssh -T gitgithub.com是否输出成功信息失败的话回到第3章的验证步骤。检查config文件里IdentityFile路径是否对文件名是不是带.pub后缀的IdentityFile必须指向私钥文件不是公钥。确认GitHub网页上SSH keys列表里有没有你正在用的这把公钥。Windows用户常见问题Git Bash不同会话里ssh-agent没启动导致私钥没被加载。每次开新窗口重新执行ssh-add ~/.ssh/github_id。6.4 经典错误Repository not found这个报错很迷惑明明仓库存在却说找不到。绝大多数原因是你当前SSH密钥对应的GitHub账号没有这个仓库的访问权限。可能性有两类仓库是私有的而密钥对的是另一个账号。仓库属于某组织而你不在该组织的成员列表里。处理方式在config里切到有权限的账号对应的Host别名修改远程地址为git别名:用户名/仓库名.git再push。6.5 远程仓库有提交导致Push被拒如果你在网页端Readme.md自动初始化过或者远程仓库里已经有了别的文件push会因为双方历史不一致被拒。这时有两个选择git pull origin main --rebase git push origin main先拉取远程最新内容放到本地最新提交的前面再推送。新手别一上来就git push -f强制覆盖强制推送是把远程历史整个换成你本地历史会把别人的提交抹掉合作项目里这么干容易被骂到怀疑人生。7. 上传完成后的收尾与日常使用建议代码推上去了不代表事情就完了。真正的日常工作里围绕SSH上传还有几个高频场景值得说说。7.1 换新电脑后怎么快速恢复换电脑最痛的不是系统安装而是把SSH密钥环境重新搭起来。推荐的做法是把旧电脑的~/.ssh目录整个备份出来github_id和github_id.pub一起拷到U盘或密码管理器。新电脑放到.ssh目录改权限Linux/macOS执行chmod 600 ~/.ssh/github_idWindows用Git Bash同样执行。不用去GitHub重新加公钥因为公钥没变直接测ssh -T gitgithub.com。千万别把私钥上传到公开仓库或聊天工具里再下载这是最危险的操作。7.2 Clone我是用SSH还是HTTPS如果只是临时拉一个别人的公开项目用HTTPS更快不用走密钥认证。但如果你要往里推送代码、或者回源拉取自己的私有项目请一定用SSH地址git clone gitgithub.com:用户名/仓库名.git一个很实用的小技巧在仓库页面可以直接选SSH下拉项复制出来的地址就是gitgithub.com:...开头直接粘贴到终端即可不用手动改。7.3 更新远程仓库地址有时候你已经用HTTPS clone下来了临时改成SSH免密用这一条git remote set-url origin gitgithub.com:用户名/仓库名.git改完可以用git remote -v验证两个URL都变成SSH格式就成功了。8. 从上传代码到正常维护一套不会出错的状态检查方法最后分享一个我用了很多年的状态自检思路很多人上传失败根本不是哪一步操作错而是不知道自己当前处于什么状态。Git是一个有状态的管理工具你要像体检一样定期检查它的状态。最常用的三个检查命令和它们解决什么问题git status # 当前工作区有没有改动有没有文件没add/commit git remote -v # 当前仓库的远程地址是什么协议对不对 git branch -vv # 当前分支和哪个远程分支关联处于领先还是落后每一条都是用来回答一个我在哪的问题。举个例子git status显示Your branch is up to date with origin/main说明本地和远程完全同步显示Your branch is ahead of origin/main by 1 commit说明本地多了一个提交需要push显示Your branch is behind说明远程有别人推送的内容需要pull。还有个值得一提的细节SSH连接正常不代表Git仓库关联正确。你可以ssh -T gitgithub.com通过认证但git push仍然失败这时候检查重点就放在git remote -v和分支关联上而不是回头去折腾密钥。根据我个人的实操体验上传项目到GitHub这件事90%的问题都集中在密钥认证失败和远程地址写错这两类上。把这套SSH流程从头到尾走一遍之后所有需要与远程仓库打交道的场景——不管是个人项目备份、开源项目贡献还是服务器自动部署——就全都顺了。你也别怕第一次push失败报错信息其实就是最好的排查指南把每条报错记下来多踩几次坑以后闭着眼都能处理。
