第 7 篇：Git 远程仓库：clone、push、pull、ignore 和 tag

文章目录Git 远程仓库clone、push、pull、ignore 和 tag一、本地仓库和远程仓库的关系二、创建远程仓库与克隆到本地三、HTTPS、SSH 和 SSH 公钥配置四、查看远程仓库信息五、push把本地提交推送到远程六、pull拉取远程更新七、.gitignore忽略不该提交的文件八、给 Git 命令配置别名九、tag 标签管理创建、查看、推送和删除1. 创建和查看标签2. 删除本地标签3. 推送标签到远程4. 删除远程标签十、本文总结Git 远程仓库clone、push、pull、ignore 和 tag前面几篇主要围绕本地仓库展开本地提交、版本回退、分支创建、分支合并、冲突解决等。这些内容解决的是“我自己电脑上的代码如何管理”的问题。但真实开发里代码通常不会只待在一台机器上。我们需要把代码同步到远程仓库方便备份、换电脑继续开发以及多人协作。于是就有了这一篇要整理的内容远程仓库、克隆、推送、拉取、忽略规则、命令别名和标签管理。这一篇涉及的命令不少但主线其实很简单git clone把远程仓库下载到本地。git remote查看本地仓库关联了哪些远程仓库。git push把本地提交推送到远程。git pull把远程更新拉取到本地。.gitignore让 Git 忽略不需要管理的文件。git tag给重要提交打标签常用于版本发布。一、本地仓库和远程仓库的关系本地仓库解决的是个人机器上的版本管理问题远程仓库解决的是代码同步、备份和协作问题。如果只有本地仓库那么代码提交都在自己的电脑上。优点是速度快、离线也能工作缺点也很明显电脑坏了代码可能丢换电脑开发不方便多人协作时也没有统一的代码交换位置。远程仓库就是为了解决这些问题的。可以把它理解成一个放在服务器上的公共仓库本地仓库和远程仓库之间通过网络同步提交从远程仓库下载代码到本地叫克隆。把本地提交上传到远程仓库叫推送。把远程仓库的新提交同步到本地叫拉取。Git 是分布式版本控制系统。分布式的意思是每个人本地都有一份完整的仓库历史而不是只保存当前文件快照。这和集中式版本控制有很大区别。集中式模式下很多操作强依赖中央服务器而 Git 本地就有完整历史所以提交、查看日志、切换分支、回退版本等操作都可以在本地完成。远程仓库更多承担的是“交换代码”和“集中备份”的职责。实际开发中常见流程是远程平台上先创建一个仓库。开发者用git clone克隆到本地。本地修改、add、commit。用git push把提交推送到远程。别人推送了新代码后用git pull拉取到本地。二、创建远程仓库与克隆到本地远程仓库可以放在 GitHub、Gitee、GitLab或者公司内部自建平台上。创建仓库的流程大同小异填写仓库名、仓库描述、可见性然后创建即可。新建远程项目仓库填写仓库基本信息创建成功后会进入仓库主页远程仓库通常还可以设置开源或私有创建好的仓库里也会有默认分支。很多平台现在默认叫main有些仓库仍然叫master。下面示例沿用master远程仓库创建好后就可以复制仓库地址进行克隆克隆命令格式很简单git clone远程仓库地址使用 HTTPS 地址克隆hyb139-159-150-152:~$ git clone https://gitee.com/hyb91/git_teaching.gitCloning intogit_teaching...Usernameforhttps://gitee.com:hyb91 Passwordforhttps://hyb91gitee.com:remote:Enumerating objects:4,done.remote:Counting objects:100%(4/4),done.remote:Compressing objects:100%(4/4),done.remote:Total4(delta0),reused0(delta0),pack-reused0Unpacking objects:100%(4/4),1.80KiB|1.80MiB/s,done.hyb139-159-150-152:~$ ls gitcode git_teaching hyb139-159-150-152:~$ ls git_teaching/README.en.md README.md克隆完成后本地会多出一个仓库目录例如这里的git_teaching。三、HTTPS、SSH 和 SSH 公钥配置Git 常见的远程访问方式有两种HTTPS 和 SSH。HTTPS 的优点是上手简单拿到仓库地址后通常就能克隆。缺点是推送时可能需要输入账号、密码或访问令牌长期开发时不够方便。SSH 的优点是配置好公钥后日常推送和拉取更顺手也更适合长期开发。缺点是第一次使用前需要生成 SSH Key并把公钥配置到远程平台。如果没有配置 SSH 公钥直接使用 SSH 地址克隆可能会失败hyb139-159-150-152:~$ git clone gitgitee.com:hyb91/git_teaching.git Cloning intogit_teaching...The authenticity of hostgitee.com (212.64.63.215)cant be established.ECDSA key fingerprint is SHA256:FQGC9Kn/eye1W8icdBgrQpKkGYoFgbVr17bmjey0Wc.Are you sure you want tocontinueconnecting(yes/no/[fingerprint])?yes Warning:Permanently addedgitee.com,212.64.63.215(ECDSA)to the list of known hosts.gitgitee.com:Permissiondenied(publickey).fatal:Couldnotread from remote repository.Please make sure you have the correct access rightsandthe repository exists.这个错误的核心是Permission denied (publickey)也就是远程平台没有识别到本机的 SSH 公钥。生成 SSH Key 之前可以先检查用户目录下是否已经有.ssh目录以及是否存在id_rsa、id_rsa.pub这类文件。如果没有可以执行hyb139-159-150-152:~$ ssh-keygen-t rsa-Cyour_emailexample.comGeneratingpublic/privatersa key pair.Enter file in which to save thekey(/home/hyb/.ssh/id_rsa):Enterpassphrase(emptyforno passphrase):Enter same passphrase again:Your identification has been saved in/home/hyb/.ssh/id_rsa Yourpublickey has been saved in/home/hyb/.ssh/id_rsa.pub The key fingerprint is:SHA256:sepKZUwKIXjJxYcot49tvOWAapEhdsRqVDFSmgQZo your_emailexample.com生成后查看.ssh目录hyb139-159-150-152:~$ ls-a.ssh/...id_rsa id_rsa.pub known_hosts这里要分清楚id_rsa是私钥不能泄露。id_rsa.pub是公钥可以配置到远程平台。接着在远程平台里找到 SSH 公钥配置入口把id_rsa.pub的内容添加进去配置完成后再使用 SSH 地址克隆就可以正常进行hyb139-159-150-152:~$ git clone gitgitee.com:hyb91/git_teaching.git Cloning intogit_teaching...Warning:Permanently added the ECDSA host keyforIP address212.64.63.190to the list of known hosts.remote:Enumerating objects:4,done.remote:Counting objects:100%(4/4),done.remote:Compressing objects:100%(4/4),done.remote:Total4(delta0),reused0(delta0),pack-reused0Receiving objects:100%(4/4),done.hyb139-159-150-152:~$ ls gitcode git_teaching hyb139-159-150-152:~$ ls git_teaching/README.en.md README.md如果是多人协作每个人都需要把自己电脑上的公钥添加到远程平台账号里这样每个人才能在自己的机器上正常推送代码。四、查看远程仓库信息当我们从远程仓库clone下来后Git 会自动建立本地分支和远程分支的关联并把远程仓库默认命名为origin。进入克隆后的仓库使用git remote可以查看远程仓库名称hyb139-159-150-152:~/git_teaching$ git remote origin使用git remote -v可以查看更详细的远程地址hyb139-159-150-152:~/git_teaching$ git remote-v origin gitgitee.com:hyb91/git_teaching.git(fetch)origin gitgitee.com:hyb91/git_teaching.git(push)这里的fetch表示拉取地址push表示推送地址。一般情况下它们相同但也可以配置成不同地址。origin不是固定魔法词只是 Git clone 后默认给远程仓库起的名字。你也可以添加其他远程仓库例如git remote add backup gitgitee.com:xxx/backup.git不过初学阶段先记住默认远程仓库通常叫origin。五、push把本地提交推送到远程克隆远程仓库后本地就可以正常修改文件、提交文件。比如新增一个file.txthyb139-159-150-152:~/git_teaching$ ls README.en.md README.md hyb139-159-150-152:~/git_teaching$ vim file.txt hyb139-159-150-152:~/git_teaching$ cat file.txt hello git提交到本地仓库hyb139-159-150-152:~/git_teaching$ git add.hyb139-159-150-152:~/git_teaching$ git commit-mcreate file.txt[master7ce3183]create file.txt create mode100644file.txt注意commit只是提交到了本地仓库远程仓库还不知道这个提交。要把本地提交同步到远程需要使用git push。git push的完整格式是git push远程主机名本地分支名:远程分支名如果本地分支名和远程分支名相同可以省略冒号后面的部分git push远程主机名本地分支名把本地master推送到远程origin/masterhyb139-159-150-152:~/git_teaching$ git push origin master Enumerating objects:4,done.Counting objects:100%(4/4),done.Compressing objects:100%(2/2),done.Writing objects:100%(3/3),308bytes|308.00KiB/s,done.Total3(delta0),reused0(delta0)remote:Powered by GITEE.COM[GNK-6.4]To gitee.com:hyb91/git_teaching.git c6ce3f0..7ce3183 master-master推送成功后远程仓库里就能看到这次提交文件也已经出现在远程仓库中这里可以顺手记住一个常见错误如果远程分支已经有了别人提交的新内容而本地没有先拉取直接推送可能会被拒绝。解决思路通常是先git pull处理完冲突后再git push。六、pull拉取远程更新远程仓库可能会出现本地没有的新提交。比如有人在远程平台上直接修改了README.md提交远程修改后此时远程仓库比本地仓库多一个提交。为了让本地保持最新需要使用git pull。git pull的完整格式是git pull远程主机名远程分支名:本地分支名如果远程分支就是要合并到当前分支可以省略冒号后面的本地分支git pull远程主机名远程分支名例如拉取远程master并合并到当前分支hyb139-159-150-152:~/git_teaching$ git pull origin master remote:Enumerating objects:5,done.remote:Counting objects:100%(5/5),done.remote:Compressing objects:100%(3/3),done.remote:Total3(delta1),reused0(delta0),pack-reused0Unpacking objects:100%(3/3),1.02KiB|1.02MiB/s,done.From gitee.com:hyb91/git_teaching*branch master-FETCH_HEAD7ce3183..60e6b0a master-origin/master Updating7ce3183..60e6b0a Fast-forward README.md|2hyb139-159-150-152:~/git_teaching$ cat README.md...第一次修改内容pull可以理解成两个动作的组合git fetch git merge也就是说它先从远程拿到最新提交再把远程提交合并到当前分支。后面多人协作时pull会非常常用尤其是在推送前先拉一下可以减少很多非快进推送和冲突问题。七、.gitignore忽略不该提交的文件日常开发中有些文件不应该交给 Git 管理比如编译生成的二进制文件。IDE 自动生成的临时配置。日志文件。本地环境配置。含有密码、密钥、访问令牌的敏感文件。这类文件可以写到.gitignore里让 Git 自动忽略。很多远程平台在创建仓库时可以帮我们生成.gitignore如果创建仓库时没有生成也可以在工作区根目录手动创建。例如忽略所有.ini和.so文件#My configurations:*.ini*.so修改.gitignore后也应该把它提交到仓库里hyb139-159-150-152:~/git_teaching$ vim.gitignore hyb139-159-150-152:~/git_teaching$ git add.hyb139-159-150-152:~/git_teaching$ git commit-madd .gitignore[master97811ab]add.gitignore create mode100644.gitignore hyb139-159-150-152:~/git_teaching$ git push origin master Enumerating objects:4,done.Counting objects:100%(4/4),done.Compressing objects:100%(2/2),done.Writing objects:100%(3/3),362bytes|362.00KiB/s,done.Total3(delta0),reused0(delta0)remote:Powered by GITEE.COM[GNK-6.4]To gitee.com:hyb91/git_teaching.git60e6b0a..97811ab master-master验证忽略规则是否生效hyb139-159-150-152:~/git_teaching$ touch a.so b.ini hyb139-159-150-152:~/git_teaching$ git status On branch master Your branch is up to date withorigin/master.nothing to commit,working tree cleangit status没有提示新增a.so和b.ini说明.gitignore生效了。如果某个文件被.gitignore忽略了但你确实想强制添加可以使用-fgit add-ffilename如果不确定某个文件为什么被忽略可以使用git check-ignore检查hyb139-159-150-152:~/git_teaching$ git check-ignore-v a.so.gitignore:3:*.so a.so这个输出表示.gitignore第 3 行的*.so规则忽略了a.so。再看一个常见规则忽略所有以.开头的隐藏文件。# 排除所有.开头的隐藏文件.*但这样会把.gitignore自己也忽略掉。如果希望例外保留.gitignore可以加上!# 排除所有.开头的隐藏文件.*# 不排除.gitignore!.gitignore.gitignore中!文件名表示反向规则也就是不要忽略这个文件。还有一个很重要的细节.gitignore只对尚未被 Git 跟踪的文件生效。如果某个文件已经被提交过后来再写进.gitignoreGit 仍然会继续跟踪它。需要先把它从索引里移除git rm--cachedfilename然后再提交.gitignore和索引变化。八、给 Git 命令配置别名有些 Git 命令比较长Git 支持给命令配置别名。比如把git status简化为git stgit config--global alias.st status--global表示全局配置这台电脑上的所有 Git 仓库都能使用。如果不加--global就只对当前仓库生效。配置后执行hyb139-159-150-152:~/git_teaching$ git st On branch master Your branch is up to date withorigin/master.nothing to commit,working tree clean再比如配置一个git last查看最后一次提交git config--global alias.lastlog -1执行效果hyb139-159-150-152:~/git_teaching$ git last commit97811abd1d43774aeb54fee32bf4fc76b2b08170(HEAD-master,origin/master,origin/HEAD)Author:hyb91your_emailexample.comDate:Fri May1217:27:0620230800add.gitignore别名可以提高效率但刚开始学 Git 时我更建议先把完整命令多敲几遍。等命令含义真正熟悉后再按自己的习惯配置别名。九、tag 标签管理创建、查看、推送和删除标签tag可以理解为给某次提交起一个稳定、好记的名字。比如项目发布v1.0时可以给对应提交打上v1.0标签。以后想查看或回到这个版本就不用记一长串 commit id。1. 创建和查看标签先切换到需要打标签的分支hyb139-159-150-152:~/git_teaching$ git branch*master给当前最新提交打标签hyb139-159-150-152:~/git_teaching$ git tag v1.0查看所有标签hyb139-159-150-152:~/git_teaching$ git tag v1.0默认情况下git tag v1.0会把标签打在当前最新提交上。如果想给历史提交打标签需要先找到对应 commit idhyb139-159-150-152:~/git_teaching$ git log--prettyoneline--abbrev-commit97811ab(HEAD-master,tag:v1.0,origin/master,origin/HEAD)add.gitignore60e6b0a update README.md.7ce3183 create file.txt c6ce3f0 Initial commit给Initial commit对应的提交打标签hyb139-159-150-152:~/git_teaching$ git tag v0.9c6ce3f0 hyb139-159-150-152:~/git_teaching$ git tag v0.9v1.0注意git tag默认按字母顺序列出标签不一定按创建时间排序。查看某个标签的详细信息hyb139-159-150-152:~/git_teaching$ git show v1.0commit97811abd1d43774aeb54fee32bf4fc76b2b08170(HEAD-master,tag:v1.0,origin/master,origin/HEAD)Author:hyb91your_emailexample.comDate:Fri May1217:27:0620230800add.gitignore diff--git a/.gitignore b/.gitignore...还可以创建带说明的标签git tag-atagname-m说明文字commit_id例如git tag-a v1.0-mrelease version 1.097811ab2. 删除本地标签如果标签打错了可以删除本地标签hyb139-159-150-152:~/git_teaching$ git tag v0.9v1.0hyb139-159-150-152:~/git_teaching$ git tag-d v0.9Deleted tagv0.9(was c6ce3f0)hyb139-159-150-152:~/git_teaching$ git tag v1.0没有推送到远程的标签只存在本地删除起来比较简单。3. 推送标签到远程标签默认不会随着普通git push origin master自动推送到远程。要推送某个标签需要显式执行git push origintagname例如推送v1.0hyb139-159-150-152:~/git_teaching$ git tag v1.0hyb139-159-150-152:~/git_teaching$ git push origin v1.0Total0(delta0),reused0(delta0)remote:Powered by GITEE.COM[GNK-6.4]To gitee.com:hyb91/git_teaching.git*[newtag]v1.0-v1.0远程平台上也能看到这个标签如果要一次性推送所有本地标签git push origin--tags4. 删除远程标签如果标签已经推送到远程删除时通常分两步。先删除本地标签hyb139-159-150-152:~/git_teaching$ git tag v1.0hyb139-159-150-152:~/git_teaching$ git tag-d v1.0Deleted tagv1.0(was97811ab)再删除远程标签hyb139-159-150-152:~/git_teaching$ git push origin:refs/tags/v1.0remote:Powered by GITEE.COM[GNK-6.4]To gitee.com:hyb91/git_teaching.git-[deleted]v1.0这个写法看起来有点奇怪可以先直接记住删除远程标签使用git push origin :refs/tags/tagname。标签常用于版本发布。例如发布一个稳定版本时可以给对应提交打v1.0.0、v1.1.0这样的标签后续排查问题、回滚版本、生成发布记录都会方便很多。十、本文总结远程仓库用于代码同步、备份和多人协作本地仓库通过clone、push、pull与远程仓库交互。Git 是分布式版本控制系统本地仓库也保存完整历史远程仓库主要负责交换代码和集中备份。git clone url可以把远程仓库克隆到本地。HTTPS 上手简单SSH 更适合长期开发使用 SSH 前需要生成 Key并把公钥添加到远程平台。git remote查看远程仓库名称git remote -v查看远程仓库地址。git push origin master可以把本地master分支推送到远程。git pull origin master可以拉取远程master并合并到当前分支。.gitignore用来忽略不需要纳入版本管理的文件git check-ignore -v可以检查某个文件被哪条规则忽略。git config --global alias.xxx可以给 Git 命令配置别名。tag适合标记重要版本节点比如v1.0、v2.0.0。标签默认只在本地推送标签需要使用git push origin tagname或git push origin --tags。到这里Git 已经从“个人本地版本管理”推进到了“本地和远程之间同步代码”。下一篇继续往下就可以进入多人协作和企业级分支模型远程分支怎么协作、同一个分支多人修改怎么办、feature 分支如何流转以及实际项目里常见的master/release/develop/feature/hotfix模型。