远程仓库、SSH公钥、git push、git pull这串关键词看着像基础课可真正上手时不少人卡在公钥配好了仍在提示输密码、仓库建好了push却失败、分支名对不上这种小地方。这篇文章就按我平时从零搭一个项目仓库的真实顺序来写注册账号、生成并配置SSH公钥、新建远端仓库、初始化本地仓库、第一次push、日常pull。我用的是某个访问稳定的国内代码托管平台流程和主流平台基本一致你把其中的域名换成自己常用的那家就行。这条链路并不长但每两个环节之间都可能藏着一个隐蔽的问题。与其百度一条命令、复制一个结果不如把整个流程从原理到操作完整过一遍后面遇到报错也知道去哪看。1. 项目标题拆解六个关键词其实是一条完整流水线1.1 从注册账号到git pull依赖顺序比命令本身更重要标题里的“注册账号、配置SSH公钥、新建远端仓库、初始化本地仓库、git push、git pull”不是六个独立动作而是一条有先后依赖的流水线先有平台账号才能配置公钥先把远端仓库建出来本地仓库才有地方推只有推上去过pull才有意义。我见过不少新手把顺序完全倒过来先在本地git initcommit完之后才去注册账号回来还要临时生成公钥。虽然最终也能跑通但中间会多出很多无意义报错比如“repository not found”“Permission denied”这类问题有时根本不是命令写错而是步骤提前了。所以我建议的依赖关系是注册账号拿到身份标识生成SSH密钥并把公钥给平台解决免密认证在平台上新建一个空仓库作为远端存储在本地初始化仓库并完成commit把本地仓库关联到远端用git push上传之后再用git pull同步。这一步一步之间有明确因果没有公钥push时平台不认识你没有远端仓库push时没有目标地址没有本地commitpush时也没有提交内容。标题把这六个动作放到一起本质上就是要你完整打通这套闭环。1.2 六个动作背后要解决的三类问题这六个关键词背后其实只有三个问题身份问题平台怎么确认你这台电脑是本人靠账号加SSH公钥存储问题代码放在哪里远端仓库负责集中存放本地仓库负责版本管理同步问题如何把本地改动送上去把远端改动拿回来靠git push和git pull。身份问题最容易被忽略。很多人第一次用平台时想直接用账号密码操作觉得简单但实际用起来很痛苦每次push都需要输密码遇到token过期还要重新申请。SSH公钥配置一次之后本地电脑就成为“可信设备”平台凭公钥辨别你私钥则始终留在本地。存储问题相对好理解。如果把本地仓库比作个人笔记本远端仓库就是一个公共资料柜。你从笔记本上复印文件放到资料柜里别人再从资料柜拿走这就是push和pull的关系。没有远端仓库本地做得再多也只是一个单机版本管理。同步问题则贯穿日常开发。push是把本地新增提交上传pull是把远端新提交抓到本地。这里容易踩坑的地方在于冲突处理同时也是Git命令最容易报错的区域。1.3 这篇内容适合谁看能帮你避掉哪些坑如果你是第一次接触代码托管平台这篇文章可以当作一份可直接照抄的操作手册如果你已经用过一段时间但还在用HTTPS方式输密码我更建议你把SSH公钥这套配好省下的时间远比你配置花掉的时间多。我最想帮你避开的坑有三个公钥复制错文件、第一次push时远端有残留文件导致历史不匹配、以及分支名不一致造成的困扰。这三种问题几乎每个初学者都会遇到而且百度出来的答案往往夹杂着各种误导操作比如让你直接git push -f覆盖远端这在协作项目里非常危险。2. 为什么推荐SSH公钥而不是账号密码原理与方案选型2.1 SSH公钥和私钥到底怎么配合SSH是一种登录协议核心要解决的问题是如何在不传输密码的情况下证明“你是你”。它靠的是一对非对称密钥公钥和私钥。我习惯用一个锁和钥匙的类比来解释公钥是一把挂在门上的锁平台拿到你的公钥后会在服务器端“装好这把锁”私钥是你手里的钥匙永远不出现在网络上。push或pull时本地Git会用私钥对请求进行签名服务器收到后拿你之前给的公钥去验签通过就说明这把钥匙确实配这把锁。这个设计最妙的地方在于私钥全程不会离开你的电脑服务器上也只存放公钥。即使平台某个服务器出问题拿到的人也无法逆推出你的私钥安全性远高于来回传输密码。在配置SSH公钥时你本地会生成两个文件一个叫id_ed25519这是私钥另一个叫id_ed25519.pub这是公钥。请务必记住粘贴到平台上的永远是.pub那个文件里的内容。私钥一旦泄露你应该立刻删除平台上的公钥配置并重新生成一对而不是继续使用原来的私钥。2.2 HTTPS和SSH方式怎么选代码托管平台一般提供两种远端地址一种以https://开头另一种以git开头。HTTPS方式配置简单浏览器能直接打开但每次push时都需要身份验证要么输入密码要么配置个人访问令牌。SSH方式配置稍复杂门槛在于生成密钥对和上传公钥但一旦完成之后就再也不用手动输入密码脚本化操作更顺畅。两者之间的取舍我一般建议对比项HTTPS方式SSH方式第一次配置无需额外操作需要生成密钥并对公钥上传日常push需要密码或token免密安全性依赖密码强度基于非对称加密适合场景偶尔操作、环境受限日常开发、命令行重度用户如果你只想推几个公开练习项目HTTPS也能接受但如果你每天都和仓库打交道SSH几乎是必选项。登录平台后尽量把默认远端地址改成git开头的SSH格式。2.3 为什么注册账号要在配置SSH之前完成注册账号这件事本身不难但有几个前置细节直接影响后面的体验。首先账号名会决定你仓库URL的一部分。很多平台上仓库地址格式是git域名:用户名/项目名.git账号名起得好不好直接影响别人记不记得住你的项目地址。其次平台会把SSH公钥和账号绑定不先注册公钥无处安放。此外我还建议注册后立刻开启两步验证。虽然SSH公钥本身已经够安全但开启两步验证可以防止有人在网页端盗用你的账号修改公钥配置或删除仓库。这个操作基本不花时间收益却很高。3. 注册账号与SSH公钥配置全流程3.1 注册账号时的实操细节注册流程很简单打开平台首页点击注册填写用户名、邮箱、密码然后收邮件验证。但有几个小细节我可少提醒一下用户名尽量用英文小写和数字组合这样生成的仓库地址干净好记。邮箱必须是你经常使用且能正常收信的邮箱因为之后很多通知、找回密码、验证操作都靠它。密码不要和平台之外的网站重复Git仓库里包含的可能不只是代码还有你无意中提交进README里的敏感信息。注册完成之后先别急着建仓库而是进入个人设置页面确认“用户名”这一栏显示的是你想要的字符。因为一旦提交了项目改用户名会导致旧链接全部失效虽然平台一般会做重定向但还是提前确认更省心。3.2 用ssh-keygen生成密钥对生成SSH密钥对在Windows、macOS、Linux上都可以直接使用系统自带的命令行工具。我强烈建议直接用ed25519算法而不是旧的RSAssh-keygen -t ed25519 -C meexample.com -f ~/.ssh/id_ed25519参数作用-t ed25519指定密钥算法为ed25519比RSA短、快、安全-C meexample.com注释信息通常填你的邮箱CPU用它识别密钥用途-f ~/.ssh/id_ed25519指定密钥保存路径和文件名不填默认就是这个路径。执行后终端会问你是否设置passphrase。这个passphrase是保护私钥的额外密码建议设一个。如果私钥被别人拷走没有passphrase也基本用不了。缺点是你每次使用密钥时可能要输入不过后面可以通过ssh-add配置免输。执行完命令后到~/.ssh目录下看应该能看到两个文件id_ed25519和id_ed25519.pub。有这两个文件才能继续。3.3 复制公钥并粘贴到平台复制公钥时最容易出错的是把私钥内容当成公钥贴上去。请时刻记住.pub后缀的是公钥。查看公钥内容cat ~/.ssh/id_ed25519.pub在macOS上可以一键复制到剪贴板pbcopy ~/.ssh/id_ed25519.pub在Windows PowerShell里则可以这样type $env:USERPROFILE\.ssh\id_ed25519.pub | clip登录你的代码托管平台进入“个人设置”或“账户设置”找到“SSH公钥”或“SSH Keys”入口。把复制到的内容粘贴到输入框里。公钥内容是一整行以ssh-ed25519开头、以注释邮箱结尾的字符串别漏掉任何开头或结尾的字符。公钥的“标题”或“名称”一栏可以随意填比如“work-laptop”“home-mac”。这个名字只用于将来管理多台电脑时区分密钥不影响连接。保存之后平台就锁定你的公钥了。3.4 用ssh命令验证是否配置成功配置完公钥后不用急着建仓库先验证一次连接ssh -T git域名这里的域名换成你注册平台对应的SSH域名。如果连接成功你会看到类似下面这样一行提示Hi username! Youve successfully authenticated, but XXXX does not provide shell access.看到Hi username就说明公钥生效了。如果你的终端提示需要输入密码或者返回Permission denied (publickey)大概率是公钥没粘贴完整或者粘贴的是私钥内容。这时需要回到平台重新编辑公钥内容再试一次。这里多说一句SSH连接验证可能会弹出一条关于known_hosts的确认信息问你是否继续连接你要输入yes回车。很多新手在这里犹豫以为输错了其实按yes确认即可。4. 新建远端仓库并初始化本地仓库4.1 在平台页面新建远端仓库的正确姿势平台注册好后点击“新建仓库”或“New Project”会进入一个表单。项目名称建议用短横线分隔的小写英文比如my-blog、user-service方便后续在URL里直接引用。这里最关键的一个决定是是否让平台自动生成README文件。如果你打算从本地初始化仓库再推送已有代码我建议选择“不生成README”“不添加.gitignore”“不添加license”。原因是远端仓库若已经有一个README文件本地仓库又是一个全新的提交历史两个历史完全没有关联第一次push时必然报“fetched this remote”之类的错误。让远端保持干净后面操作会顺畅很多。同时推荐把仓库可见性设为“私有”。很多人习惯把所有练习项目设成公开想着以后展示方便但公开仓库意味着任何人都能看到你的代码有时还会被自动化工具扫描。稳妥起见练习项目先私有确定要开源时再改公开。4.2 在本地初始化一个仓库打开终端进入准备放项目的目录。我先建一个空目录并进入mkdir my-blog cd my-blog然后执行git init执行完之后目录里会多出一个隐藏的.git文件夹这个文件夹就是本地仓库的版本数据库。今后所有commit、branch信息都存在里面。接着创建项目文件。假如这里你写了一个README.md需要先把它加入暂存区再提交git add README.md git commit -m init commitgit add把文件放进暂存区git commit把暂存区内容固化成一次版本快照。很多人会在第一次提交时忘记配置用户信息于是Git报错提示需要user.name和user.email。在提交前最好先检查一遍git config --global user.name username git config --global user.email meexample.com这里的用户名和邮箱会记录在提交历史上尽量和平台注册信息保持一致别人看历史时才知道作者是你。建议在项目里提前写好.gitignore文件把系统临时文件、日志、依赖目录等排除在版本管理之外否则一个git add .会把大量无关文件塞进仓库后面清理起来极其麻烦。4.3 把本地仓库关联到远端仓库回到平台新建好的仓库页面页面上一般会提供两类地址HTTPS地址和SSH地址。这里请复制git开头的SSH地址例如git域名:username/my-blog.git。在本地仓库里执行git remote add origin git域名:username/my-blog.gitorigin是Git约定俗成的默认远程仓库别名你可以改成任何名字但我建议保持origin因为绝大多数文档和命令默认它。执行完后用git remote -v确认地址是否正确git remote -v你应该看到两个输出一个fetch地址和一个push地址内容都是刚才添加的那条SSH地址。如果地址写错了可以用git remote set-url origin 正确地址来修改不用删了重加。4.4 第一次push把本地提交推上远端关联完远端后第一次push需要带上-u参数git push -u origin main这里的main是当前分支名。如果你的默认分支是master就写成git push -u origin master。-u的作用是设置上游分支告诉Git本地main分支对应远端origin/main分支。设置成功之后以后再push只需输入git push或git push origin main即可。如果一切正常终端会显示推送进度最后出现类似main - main的输出。这时刷新平台仓库页面应该能看到你的代码了。第一次push常见的失败有两种一是SSH公钥问题二是远端和本地历史不关联。如果是后者请看第6章不要贸然使用git push -f。5. 日常开发中的git push与git pull5.1 push的三步走和常用参数配置好第一次push后日常push不变的是“三步走”git add . git commit -m commit message git pushgit add .把当前目录所有改动加入暂存区git commit生成一次本地提交git push把这次提交推送到远端。这里最容易忽视的是提交信息质量。fix bug、update这种提交信息在单人项目里勉强能看但在多人项目里会对查看历史造成极大困扰。建议用“动词对象原因”的格式比如“修复登录接口空指针导致用户无法登录”。push的参数里我强烈建议你熟悉--force-with-lease而不是-f。git push -f会无条件覆盖远端分支而--force-with-lease会在确认远端没有别人新提交后才执行覆盖相当于给强制操作加了一个安全锁。需要覆盖历史时优先用git push --force-with-lease origin main5.2 pull的本质是fetch加merge很多人以为git pull是“把远端代码下载到本地”这个说法不准确。准确地说git pull内部做了两件事先git fetch把远端提交拉到本地暂存区再git merge把它合并到当前分支。所以完全可以用两个命令替代一次pullgit fetch origin git merge origin/main理解这点后就会明白为什么有时git pull会产生一个“merge commit”为什么本地会有分叉历史。如果你希望历史更干净可以使用git pull --rebase它不会生成额外合并节点而是把本地提交“搬到”远端最新提交后面。不过rebase也有代价它会改写本地提交时间线还没有完全掌握前先在个人分支上用。日常操作中我建议在pull前先确认自己没有未提交的修改。可以执行git status如果显示工作区不干净先commit或stash再pull否则可能遇到“local changes would be overwritten”的报错。5.3 多远端仓库的同步思路有时同一个项目需要推送到两个不同的远端仓库比如一个主仓一个备份仓。我的做法是添加新的remote名称git remote add backup git域名:username/my-blog.git git push backup main这样本地仓库同时关联了origin和backup两个远端推送时通过名字区分。也有人希望一个git push同时推送多个远端这时可以给同一个命名添加多个URL但日常维护容易混乱。我倒是建议不要过度自动化显式推送两条命令至少能让自己知道你在干什么。6. 常见问题与排查技巧实录6.1 Permission denied (publickey) 到底卡在哪这是SSH方式最高频的报错。遇到这行按以下顺序逐步排查ls ~/.ssh确认有没有id_ed25519和id_ed25519.pub两个文件cat ~/.ssh/id_ed25519.pub确认公钥内容是以ssh-ed25519开头的一整行回到平台“SSH公钥”页面确认粘贴的字符串和本地公钥完全一致有没有多空格、丢字符执行ssh -T git域名确认是否出现Hi username提示。还有一个常见坑是私钥未被SSH agent加载。执行ssh-add -l如果提示The agent has no identities需要先把私钥加入ssh-add ~/.ssh/id_ed25519另外如果你同时维护了多个SSH密钥还要检查~/.ssh/config里的Host配置确保当前仓库域名指向了正确的私钥文件。否则Git会默认使用第一个私钥去连接导致平台不认识你。6.2 第一次push提示“rejected: Remote contains work”这个报错往往是因为平台新建仓库时勾选了“初始化README”导致远端多了一个本地没有的提交。两个仓库就像两本平行的历史书Git不敢自动合并。正确做法有两种如果你确认本地已经是完整内容可以用git pull origin main --allow-unrelated-histories把远端初始README合并进本地再push如果远端只是空壳仓库里面什么都不需要保留可以推的时候加--force-with-lease把远端那个孤立提交覆盖掉。我建议先试第一种因为它更安全。6.3 分支名是main还是master很多平台默认新仓库分支名为main但早期版本和部分旧习惯仍用masterpush时就会遇到src refspec main does not match any。处理方式是在本地把分支重命名git branch -M main然后再pushgit push -u origin main如果远端仓库已经有了master分支本地又不想改名可以用git push origin main:master把本地main分支推送到远端master分支。这种映射写法偶尔应急可以长期用还是建议统一分支名减少认知负担。6.4 每次都提示输入用户名密码哪怕配置了SSH如果你已经上传了公钥push时却仍然提示输入用户名和密码八成原因是当前仓库的remote地址还是https://格式。执行git remote -v如果看到的是https://开头说明Git走的是HTTP方式SSH公钥当然派不上用场。改成SSH地址即可git remote set-url origin git域名:username/my-blog.git改完后再次push应该就不再询问密码了。6.5 连接超时或无法访问SSH连接超时有时不是密钥问题而是网络环境因素。遇到这种问题先检查能否用浏览器打开平台页面如果页面也打不开说明是网络层面的问题先去解决网络连通性。平台一般在SSH服务上支持443端口的连接。如果你的网络环境拦截默认22端口可以尝试切换为ssh.github.com这类443端口地址。具体写法要根据你使用的平台而定大致是ssh -T -p 443 gitssh.平台域名很多主流平台都提供类似方案。如果实在连不上带着HTTPS方式继续用也不是不行总比阻塞整天强。写在后面我的一个习惯最后分享一个我自己调整过的操作习惯新建项目时永远先在本地init并commit一次再上平台建空仓库。这个顺序也许和平台页面引导相反但能逼我在上手代码前就搭好项目结构也避免了远端自动生成README带来的历史分叉问题。等你哪天把“先看remote属性、再跑push、拉不动就先fetch单看差异”变成肌肉记忆这套流程就算真正吃透了。
远程仓库、SSH公钥、git push、git pull这串关键词看着像基础课可真正上手时不少人卡在公钥配好了仍在提示输密码、仓库建好了push却失败、分支名对不上这种小地方。这篇文章就按我平时从零搭一个项目仓库的真实顺序来写注册账号、生成并配置SSH公钥、新建远端仓库、初始化本地仓库、第一次push、日常pull。我用的是某个访问稳定的国内代码托管平台流程和主流平台基本一致你把其中的域名换成自己常用的那家就行。这条链路并不长但每两个环节之间都可能藏着一个隐蔽的问题。与其百度一条命令、复制一个结果不如把整个流程从原理到操作完整过一遍后面遇到报错也知道去哪看。1. 项目标题拆解六个关键词其实是一条完整流水线1.1 从注册账号到git pull依赖顺序比命令本身更重要标题里的“注册账号、配置SSH公钥、新建远端仓库、初始化本地仓库、git push、git pull”不是六个独立动作而是一条有先后依赖的流水线先有平台账号才能配置公钥先把远端仓库建出来本地仓库才有地方推只有推上去过pull才有意义。我见过不少新手把顺序完全倒过来先在本地git initcommit完之后才去注册账号回来还要临时生成公钥。虽然最终也能跑通但中间会多出很多无意义报错比如“repository not found”“Permission denied”这类问题有时根本不是命令写错而是步骤提前了。所以我建议的依赖关系是注册账号拿到身份标识生成SSH密钥并把公钥给平台解决免密认证在平台上新建一个空仓库作为远端存储在本地初始化仓库并完成commit把本地仓库关联到远端用git push上传之后再用git pull同步。这一步一步之间有明确因果没有公钥push时平台不认识你没有远端仓库push时没有目标地址没有本地commitpush时也没有提交内容。标题把这六个动作放到一起本质上就是要你完整打通这套闭环。1.2 六个动作背后要解决的三类问题这六个关键词背后其实只有三个问题身份问题平台怎么确认你这台电脑是本人靠账号加SSH公钥存储问题代码放在哪里远端仓库负责集中存放本地仓库负责版本管理同步问题如何把本地改动送上去把远端改动拿回来靠git push和git pull。身份问题最容易被忽略。很多人第一次用平台时想直接用账号密码操作觉得简单但实际用起来很痛苦每次push都需要输密码遇到token过期还要重新申请。SSH公钥配置一次之后本地电脑就成为“可信设备”平台凭公钥辨别你私钥则始终留在本地。存储问题相对好理解。如果把本地仓库比作个人笔记本远端仓库就是一个公共资料柜。你从笔记本上复印文件放到资料柜里别人再从资料柜拿走这就是push和pull的关系。没有远端仓库本地做得再多也只是一个单机版本管理。同步问题则贯穿日常开发。push是把本地新增提交上传pull是把远端新提交抓到本地。这里容易踩坑的地方在于冲突处理同时也是Git命令最容易报错的区域。1.3 这篇内容适合谁看能帮你避掉哪些坑如果你是第一次接触代码托管平台这篇文章可以当作一份可直接照抄的操作手册如果你已经用过一段时间但还在用HTTPS方式输密码我更建议你把SSH公钥这套配好省下的时间远比你配置花掉的时间多。我最想帮你避开的坑有三个公钥复制错文件、第一次push时远端有残留文件导致历史不匹配、以及分支名不一致造成的困扰。这三种问题几乎每个初学者都会遇到而且百度出来的答案往往夹杂着各种误导操作比如让你直接git push -f覆盖远端这在协作项目里非常危险。2. 为什么推荐SSH公钥而不是账号密码原理与方案选型2.1 SSH公钥和私钥到底怎么配合SSH是一种登录协议核心要解决的问题是如何在不传输密码的情况下证明“你是你”。它靠的是一对非对称密钥公钥和私钥。我习惯用一个锁和钥匙的类比来解释公钥是一把挂在门上的锁平台拿到你的公钥后会在服务器端“装好这把锁”私钥是你手里的钥匙永远不出现在网络上。push或pull时本地Git会用私钥对请求进行签名服务器收到后拿你之前给的公钥去验签通过就说明这把钥匙确实配这把锁。这个设计最妙的地方在于私钥全程不会离开你的电脑服务器上也只存放公钥。即使平台某个服务器出问题拿到的人也无法逆推出你的私钥安全性远高于来回传输密码。在配置SSH公钥时你本地会生成两个文件一个叫id_ed25519这是私钥另一个叫id_ed25519.pub这是公钥。请务必记住粘贴到平台上的永远是.pub那个文件里的内容。私钥一旦泄露你应该立刻删除平台上的公钥配置并重新生成一对而不是继续使用原来的私钥。2.2 HTTPS和SSH方式怎么选代码托管平台一般提供两种远端地址一种以https://开头另一种以git开头。HTTPS方式配置简单浏览器能直接打开但每次push时都需要身份验证要么输入密码要么配置个人访问令牌。SSH方式配置稍复杂门槛在于生成密钥对和上传公钥但一旦完成之后就再也不用手动输入密码脚本化操作更顺畅。两者之间的取舍我一般建议对比项HTTPS方式SSH方式第一次配置无需额外操作需要生成密钥并对公钥上传日常push需要密码或token免密安全性依赖密码强度基于非对称加密适合场景偶尔操作、环境受限日常开发、命令行重度用户如果你只想推几个公开练习项目HTTPS也能接受但如果你每天都和仓库打交道SSH几乎是必选项。登录平台后尽量把默认远端地址改成git开头的SSH格式。2.3 为什么注册账号要在配置SSH之前完成注册账号这件事本身不难但有几个前置细节直接影响后面的体验。首先账号名会决定你仓库URL的一部分。很多平台上仓库地址格式是git域名:用户名/项目名.git账号名起得好不好直接影响别人记不记得住你的项目地址。其次平台会把SSH公钥和账号绑定不先注册公钥无处安放。此外我还建议注册后立刻开启两步验证。虽然SSH公钥本身已经够安全但开启两步验证可以防止有人在网页端盗用你的账号修改公钥配置或删除仓库。这个操作基本不花时间收益却很高。3. 注册账号与SSH公钥配置全流程3.1 注册账号时的实操细节注册流程很简单打开平台首页点击注册填写用户名、邮箱、密码然后收邮件验证。但有几个小细节我可少提醒一下用户名尽量用英文小写和数字组合这样生成的仓库地址干净好记。邮箱必须是你经常使用且能正常收信的邮箱因为之后很多通知、找回密码、验证操作都靠它。密码不要和平台之外的网站重复Git仓库里包含的可能不只是代码还有你无意中提交进README里的敏感信息。注册完成之后先别急着建仓库而是进入个人设置页面确认“用户名”这一栏显示的是你想要的字符。因为一旦提交了项目改用户名会导致旧链接全部失效虽然平台一般会做重定向但还是提前确认更省心。3.2 用ssh-keygen生成密钥对生成SSH密钥对在Windows、macOS、Linux上都可以直接使用系统自带的命令行工具。我强烈建议直接用ed25519算法而不是旧的RSAssh-keygen -t ed25519 -C meexample.com -f ~/.ssh/id_ed25519参数作用-t ed25519指定密钥算法为ed25519比RSA短、快、安全-C meexample.com注释信息通常填你的邮箱CPU用它识别密钥用途-f ~/.ssh/id_ed25519指定密钥保存路径和文件名不填默认就是这个路径。执行后终端会问你是否设置passphrase。这个passphrase是保护私钥的额外密码建议设一个。如果私钥被别人拷走没有passphrase也基本用不了。缺点是你每次使用密钥时可能要输入不过后面可以通过ssh-add配置免输。执行完命令后到~/.ssh目录下看应该能看到两个文件id_ed25519和id_ed25519.pub。有这两个文件才能继续。3.3 复制公钥并粘贴到平台复制公钥时最容易出错的是把私钥内容当成公钥贴上去。请时刻记住.pub后缀的是公钥。查看公钥内容cat ~/.ssh/id_ed25519.pub在macOS上可以一键复制到剪贴板pbcopy ~/.ssh/id_ed25519.pub在Windows PowerShell里则可以这样type $env:USERPROFILE\.ssh\id_ed25519.pub | clip登录你的代码托管平台进入“个人设置”或“账户设置”找到“SSH公钥”或“SSH Keys”入口。把复制到的内容粘贴到输入框里。公钥内容是一整行以ssh-ed25519开头、以注释邮箱结尾的字符串别漏掉任何开头或结尾的字符。公钥的“标题”或“名称”一栏可以随意填比如“work-laptop”“home-mac”。这个名字只用于将来管理多台电脑时区分密钥不影响连接。保存之后平台就锁定你的公钥了。3.4 用ssh命令验证是否配置成功配置完公钥后不用急着建仓库先验证一次连接ssh -T git域名这里的域名换成你注册平台对应的SSH域名。如果连接成功你会看到类似下面这样一行提示Hi username! Youve successfully authenticated, but XXXX does not provide shell access.看到Hi username就说明公钥生效了。如果你的终端提示需要输入密码或者返回Permission denied (publickey)大概率是公钥没粘贴完整或者粘贴的是私钥内容。这时需要回到平台重新编辑公钥内容再试一次。这里多说一句SSH连接验证可能会弹出一条关于known_hosts的确认信息问你是否继续连接你要输入yes回车。很多新手在这里犹豫以为输错了其实按yes确认即可。4. 新建远端仓库并初始化本地仓库4.1 在平台页面新建远端仓库的正确姿势平台注册好后点击“新建仓库”或“New Project”会进入一个表单。项目名称建议用短横线分隔的小写英文比如my-blog、user-service方便后续在URL里直接引用。这里最关键的一个决定是是否让平台自动生成README文件。如果你打算从本地初始化仓库再推送已有代码我建议选择“不生成README”“不添加.gitignore”“不添加license”。原因是远端仓库若已经有一个README文件本地仓库又是一个全新的提交历史两个历史完全没有关联第一次push时必然报“fetched this remote”之类的错误。让远端保持干净后面操作会顺畅很多。同时推荐把仓库可见性设为“私有”。很多人习惯把所有练习项目设成公开想着以后展示方便但公开仓库意味着任何人都能看到你的代码有时还会被自动化工具扫描。稳妥起见练习项目先私有确定要开源时再改公开。4.2 在本地初始化一个仓库打开终端进入准备放项目的目录。我先建一个空目录并进入mkdir my-blog cd my-blog然后执行git init执行完之后目录里会多出一个隐藏的.git文件夹这个文件夹就是本地仓库的版本数据库。今后所有commit、branch信息都存在里面。接着创建项目文件。假如这里你写了一个README.md需要先把它加入暂存区再提交git add README.md git commit -m init commitgit add把文件放进暂存区git commit把暂存区内容固化成一次版本快照。很多人会在第一次提交时忘记配置用户信息于是Git报错提示需要user.name和user.email。在提交前最好先检查一遍git config --global user.name username git config --global user.email meexample.com这里的用户名和邮箱会记录在提交历史上尽量和平台注册信息保持一致别人看历史时才知道作者是你。建议在项目里提前写好.gitignore文件把系统临时文件、日志、依赖目录等排除在版本管理之外否则一个git add .会把大量无关文件塞进仓库后面清理起来极其麻烦。4.3 把本地仓库关联到远端仓库回到平台新建好的仓库页面页面上一般会提供两类地址HTTPS地址和SSH地址。这里请复制git开头的SSH地址例如git域名:username/my-blog.git。在本地仓库里执行git remote add origin git域名:username/my-blog.gitorigin是Git约定俗成的默认远程仓库别名你可以改成任何名字但我建议保持origin因为绝大多数文档和命令默认它。执行完后用git remote -v确认地址是否正确git remote -v你应该看到两个输出一个fetch地址和一个push地址内容都是刚才添加的那条SSH地址。如果地址写错了可以用git remote set-url origin 正确地址来修改不用删了重加。4.4 第一次push把本地提交推上远端关联完远端后第一次push需要带上-u参数git push -u origin main这里的main是当前分支名。如果你的默认分支是master就写成git push -u origin master。-u的作用是设置上游分支告诉Git本地main分支对应远端origin/main分支。设置成功之后以后再push只需输入git push或git push origin main即可。如果一切正常终端会显示推送进度最后出现类似main - main的输出。这时刷新平台仓库页面应该能看到你的代码了。第一次push常见的失败有两种一是SSH公钥问题二是远端和本地历史不关联。如果是后者请看第6章不要贸然使用git push -f。5. 日常开发中的git push与git pull5.1 push的三步走和常用参数配置好第一次push后日常push不变的是“三步走”git add . git commit -m commit message git pushgit add .把当前目录所有改动加入暂存区git commit生成一次本地提交git push把这次提交推送到远端。这里最容易忽视的是提交信息质量。fix bug、update这种提交信息在单人项目里勉强能看但在多人项目里会对查看历史造成极大困扰。建议用“动词对象原因”的格式比如“修复登录接口空指针导致用户无法登录”。push的参数里我强烈建议你熟悉--force-with-lease而不是-f。git push -f会无条件覆盖远端分支而--force-with-lease会在确认远端没有别人新提交后才执行覆盖相当于给强制操作加了一个安全锁。需要覆盖历史时优先用git push --force-with-lease origin main5.2 pull的本质是fetch加merge很多人以为git pull是“把远端代码下载到本地”这个说法不准确。准确地说git pull内部做了两件事先git fetch把远端提交拉到本地暂存区再git merge把它合并到当前分支。所以完全可以用两个命令替代一次pullgit fetch origin git merge origin/main理解这点后就会明白为什么有时git pull会产生一个“merge commit”为什么本地会有分叉历史。如果你希望历史更干净可以使用git pull --rebase它不会生成额外合并节点而是把本地提交“搬到”远端最新提交后面。不过rebase也有代价它会改写本地提交时间线还没有完全掌握前先在个人分支上用。日常操作中我建议在pull前先确认自己没有未提交的修改。可以执行git status如果显示工作区不干净先commit或stash再pull否则可能遇到“local changes would be overwritten”的报错。5.3 多远端仓库的同步思路有时同一个项目需要推送到两个不同的远端仓库比如一个主仓一个备份仓。我的做法是添加新的remote名称git remote add backup git域名:username/my-blog.git git push backup main这样本地仓库同时关联了origin和backup两个远端推送时通过名字区分。也有人希望一个git push同时推送多个远端这时可以给同一个命名添加多个URL但日常维护容易混乱。我倒是建议不要过度自动化显式推送两条命令至少能让自己知道你在干什么。6. 常见问题与排查技巧实录6.1 Permission denied (publickey) 到底卡在哪这是SSH方式最高频的报错。遇到这行按以下顺序逐步排查ls ~/.ssh确认有没有id_ed25519和id_ed25519.pub两个文件cat ~/.ssh/id_ed25519.pub确认公钥内容是以ssh-ed25519开头的一整行回到平台“SSH公钥”页面确认粘贴的字符串和本地公钥完全一致有没有多空格、丢字符执行ssh -T git域名确认是否出现Hi username提示。还有一个常见坑是私钥未被SSH agent加载。执行ssh-add -l如果提示The agent has no identities需要先把私钥加入ssh-add ~/.ssh/id_ed25519另外如果你同时维护了多个SSH密钥还要检查~/.ssh/config里的Host配置确保当前仓库域名指向了正确的私钥文件。否则Git会默认使用第一个私钥去连接导致平台不认识你。6.2 第一次push提示“rejected: Remote contains work”这个报错往往是因为平台新建仓库时勾选了“初始化README”导致远端多了一个本地没有的提交。两个仓库就像两本平行的历史书Git不敢自动合并。正确做法有两种如果你确认本地已经是完整内容可以用git pull origin main --allow-unrelated-histories把远端初始README合并进本地再push如果远端只是空壳仓库里面什么都不需要保留可以推的时候加--force-with-lease把远端那个孤立提交覆盖掉。我建议先试第一种因为它更安全。6.3 分支名是main还是master很多平台默认新仓库分支名为main但早期版本和部分旧习惯仍用masterpush时就会遇到src refspec main does not match any。处理方式是在本地把分支重命名git branch -M main然后再pushgit push -u origin main如果远端仓库已经有了master分支本地又不想改名可以用git push origin main:master把本地main分支推送到远端master分支。这种映射写法偶尔应急可以长期用还是建议统一分支名减少认知负担。6.4 每次都提示输入用户名密码哪怕配置了SSH如果你已经上传了公钥push时却仍然提示输入用户名和密码八成原因是当前仓库的remote地址还是https://格式。执行git remote -v如果看到的是https://开头说明Git走的是HTTP方式SSH公钥当然派不上用场。改成SSH地址即可git remote set-url origin git域名:username/my-blog.git改完后再次push应该就不再询问密码了。6.5 连接超时或无法访问SSH连接超时有时不是密钥问题而是网络环境因素。遇到这种问题先检查能否用浏览器打开平台页面如果页面也打不开说明是网络层面的问题先去解决网络连通性。平台一般在SSH服务上支持443端口的连接。如果你的网络环境拦截默认22端口可以尝试切换为ssh.github.com这类443端口地址。具体写法要根据你使用的平台而定大致是ssh -T -p 443 gitssh.平台域名很多主流平台都提供类似方案。如果实在连不上带着HTTPS方式继续用也不是不行总比阻塞整天强。写在后面我的一个习惯最后分享一个我自己调整过的操作习惯新建项目时永远先在本地init并commit一次再上平台建空仓库。这个顺序也许和平台页面引导相反但能逼我在上手代码前就搭好项目结构也避免了远端自动生成README带来的历史分叉问题。等你哪天把“先看remote属性、再跑push、拉不动就先fetch单看差异”变成肌肉记忆这套流程就算真正吃透了。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
