先说个很多人没想通的点Git本身其实没有“下载某个分支”这个动作。执行git clone的时候整个仓库的所有提交历史都会拉到本地GitHub上的远程分支也会同步成一份本地镜像只是最后默认帮你检出了主分支而已。所以“用git下载GitHub分支”这个问题拆开看就是两件事——怎么只拿指定分支的代码以及怎么在本地切到那个分支。本篇面向两类人一是刚接触Git的萌新照着做能把代码稳稳拉下来不报错、不迷路二是平时只用IDEA、VSCode里的图形按钮、从来没搞清楚底层命令的同学。我会从安装Git、配置SSH讲起把命令行、IDE、TortoiseGit三种操作方式都过一遍再附上我这些年踩过的坑和排查方法。全文没有废话步骤可以直接照着敲。1. 准备阶段装好Git并打通GitHub连接下载分支之前先确认电脑上有Git而且能连上GitHub。这一步卡住的人不少我见过有人在IDEA里点分支切换点了半天没反应最后发现是Git压根没装好或者SSH Key没配白白折腾半小时。1.1 安装GitWindows、macOS、Linux三条路子Windows用户最简单的方式是去Git官网下载Git for Windows安装包一路Next安装完。安装过程中有几个选项值得留意第一默认编辑器建议选Vim或者Nano不要选“Use Notepad”否则以后提交信息编辑体验很差第二“Adjusting your PATH environment”这一步一定选默认的“Git from the command line and also from 3rd-party software”这样IDEA、VSCode这些工具才能自动识别到Git。如果你习惯用命令行装Windows 10以上版本可以直接在管理员PowerShell里敲winget install --id Git.Git -e --source wingetmacOS自带Git但版本可能偏老。我建议用Homebrew装新版brew install gitLinux用户按发行版来Debian/Ubuntu用aptCentOS/RHEL用yumsudo apt install git sudo yum install git装完验证一下能输出版本号就说明成功了git --versionWindows下安装完成后桌面右键应该能看到“Git Bash Here”和“Git GUI Here”两个菜单项。Git Bash就是Windows上的Linux风格命令行环境后面我所有命令都建议在Git Bash里执行避免CMD的转义问题。1.2 首次使用必做的用户配置Git提交代码时每条commit都会记录作者名字和邮箱。这个信息不配置仓库会让你提交时一定报错或者强制让你临时配置。全局配置一次以后所有仓库都生效git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com名字用中文也行但建议用GitHub用户名保持一致这样你在GitHub上的提交记录能正确关联到你的账号。查看当前配置用git config --list再补一个实用配置Windows下设置行尾自动转换避免跨平台时文件换行符一团乱git config --global core.autocrlf truemacOS/Linux则不需要保持默认即可。1.3 连接GitHub的两种方式HTTPS和SSHGit克隆GitHub仓库地址有两种协议一个是HTTPS一个是SSH。HTTPS地址长这样https://github.com/你的用户名/仓库名.gitSSH地址长这样gitgithub.com:你的用户名/仓库名.git两者的区别在于认证方式。HTTPS在2021年8月之后不能再拿GitHub登录密码做认证了必须使用Personal Access Token也就是个人访问令牌。SSH则是靠密钥对认证配置一次之后长期有效不用反复输入账号密码。日常开发我强烈建议用SSH。生成密钥的命令ssh-keygen -t ed25519 -C 你的邮箱example.com一路回车默认会在~/.ssh/下生成两个文件私钥id_ed25519和公钥id_ed25519.pub。私钥自己保存好公钥要添加到GitHub上。用下面的命令把公钥内容打印出来cat ~/.ssh/id_ed25519.pub复制输出的一整行内容打开GitHub网页头像右上角菜单进入Settings左侧找到“SSH and GPG keys”点击“New SSH key”Title随便填Key里粘贴公钥保存即可。验证是否配置成功ssh -T gitgithub.com如果看到类似Hi 你的用户名! Youve successfully authenticated的提示说明SSH已经通了。2. 分支原理与clone行为先搞清楚再动手很多人用Git几年了还是没搞明白分支的本质遇到“远程分支拉不下来”“切分支报错”就抓瞎。其实分支背后的原理非常简单花五分钟搞清楚后面所有操作都会变得顺理成章。2.1 分支的本质一个会移动的指针Git里的分支说白了就是指向某一次提交commit的指针。每次commit之后当前分支指针就会自动往前移动指向最新提交。而HEAD这个特殊指针则指向你当前所在的分支用来告诉Git你现在站在哪里。用生活化的例子解释Git仓库就像一本不断变厚的日记本每次提交就是写一页新日记记录从第一页到最新一页的所有内容。分支就像是夹在日记本里的书签书签指到哪一页就代表这条开发线走到了哪一步。你可以同时夹很多个书签也可以随手新建一个书签从当前页开始继续写这就是“创建分支”。远程分支在本地也有对应的镜像引用统一叫origin/分支名比如GitHub上的dev分支在本地就叫origin/dev。这个镜像引用不是真正的本地分支它只是本地缓存的一份远程分支位置记录需要fetch之后才会更新。2.2 git clone到底下载了什么这是个被误解很深的知识点。很多教程说git clone会下载整个仓库但对“整个”两个字理解有偏差。实际上git clone会下载三样东西全部提交历史、全部标签、以及所有远程分支的引用信息。但是默认情况下它只在本地创建一个分支也就是仓库的默认分支通常是main或master并且自动检出这个分支的代码。其他分支的代码并没有出现在你的工作区里只是远程分支的引用被下载下来了。也就是说你clone完一个多分支仓库之后执行git branch只看到一条本地分支但执行git branch -r能看到一堆origin/xxx远程分支。这就是“远程明明有分支本地怎么只有一条”的真相。2.3 本地分支和远程分支的跟踪关系Git里面有个“跟踪”机制本地分支可以设定跟踪哪个远程分支。设定之后git pull和git push就能自动判断该从哪里拉、往哪里推不用每次指定远程分支名。最常见的跟踪关系是clone过程中自动建立的本地main分支自动跟踪origin/main。手动创建跟踪关系用git checkout -b dev origin/dev这条命令做了两件事基于origin/dev创建本地分支dev并让本地dev自动跟踪origin/dev。更直观的写法是用--track参数git branch --track dev origin/dev查看所有本地分支和远程分支的跟踪关系git branch -vv输出里[origin/dev]就表示当前分支正在跟踪origin/dev后面跟着的是最近一次提交的hash和提交信息。3. 下载GitHub指定分支的四种姿势理论部分够用了现在上实操。下载GitHub上的指定分支我总结了四种方式覆盖从“只想要代码看看”到“需要完整历史继续开发”的所有场景。大家按需求选不用每种都学但建议都看一遍理解了之后以后遇到类似问题一眼就能判断该用哪招。3.1 最直接的姿势git clone -b 分支名 仓库地址如果你明确知道要下载哪个分支这是最简单、最推荐的做法。命令格式git clone -b dev https://github.com/你的用户名/仓库名.git-b参数就是--branch的简写意思是clone完成之后直接帮你检出指定的分支。执行完之后你的工作区就是dev分支的代码本地分支列表里也会自动创建一个对应的dev分支。实操示例git clone -b dev https://github.com/example/blog.git如果你是SSH配置好了也可以用SSH地址git clone -b dev gitgithub.com:example/blog.git这一步有一个值得注意的现象clone出来的仓库里git branch只会看到本地的dev分支但执行git branch -a仍然能看到所有远程分支引用比如origin/main、origin/test。这说明Git并没有只下载dev这一个分支的代码它下载了整个仓库的提交历史再帮我们把当前工作区定位在dev分支上而已。如果仓库历史很大、分支很多而你只需要某一个分支的最新代码不想下载全部历史可以叠加两个参数git clone -b dev --single-branch https://github.com/example/blog.git git clone -b dev --single-branch --depth 1 https://github.com/example/blog.git--single-branch让Git只下载指定分支的提交历史--depth 1只拉取最近一次提交也就是浅克隆。这样下载体积会大幅缩小特别适合那种历史提交动辄几个GB的大型仓库。缺点是拿不到完整历史记录后续如果需要全量历史得用git fetch --unshallow把这个浅克隆补全。3.2 先全量克隆再切换分支git clone git checkout有些场景下你不知道这个仓库有哪些分支或者想先整体看看仓库结构再选分支这时候就先普通clone整个仓库再切换到目标分支。第一步先全量克隆git clone https://github.com/你的用户名/仓库名.git cd 仓库名第二步查看有哪些远程分支注意是用-r参数git branch -r输出大概是这样的origin/HEAD - origin/main origin/dev origin/feature/login origin/main origin/test看到目标分支后切换过去。Git 2.23版本以后可以直接用git checkout dev新版本Git发现本地没有叫dev的分支但远程有对应的origin/dev会自动帮你创建本地分支并建立跟踪关系。如果你的Git版本比较老可能不会自动创建会报错这时就手动指定git checkout -b dev origin/dev这种方式的好处是灵活clone的时候不用想太多拉下来之后想切哪个分支切哪个分支完全看心情。缺点是如果仓库历史很大全量clone本身就够呛哪怕你只要一个分支也得等整个仓库下载完。3.3 精细控制下载git fetch git checkout -b第三种方式适合那些已经有一个仓库、想额外拉取某个远程分支的场景。比如你本地仓库是别人给的git remote -v一看远程地址指向GitHub但远程分支列表里没有你想要的那个分支这时候用fetch精准获取。如果你还没有本地仓库从头建立连接mkdir 仓库名 cd 仓库名 git init git remote add origin https://github.com/你的用户名/仓库名.git git fetch originfetch之后执行git branch -r就能看到所有远程分支了。然后基于远程分支创建本地分支git checkout -b dev origin/dev为什么推荐这种方式而不是直接clone整个仓库因为fetch做的是增量拉取Git会先比较本地已有对象和远程对象的差异只下载缺失的部分。对于已有仓库来说fetch比重新clone快得多。另外git fetch和git pull是很多新手容易混淆的一对命令。pull是fetch和merge的合体先拉取远程更新再立即合并到当前分支。fetch只是把远程分支的更新拉到本地但不会动你当前工作区的内容。在分支下载和切换的场景里fetch明显更安全因为你可以先看看拉下来的是什么再决定切不切换。Git 2.23开始官方推荐用git switch替代部分git checkout的用法。切换已有分支git switch dev创建并切换新分支git switch -c dev origin/dev3.4 不装Git也能拿代码GitHub网页下载ZIP最后一个方式属于“偷懒方案”适合只是想看看代码、临时用一下、不会继续参与开发的同学。在GitHub仓库页面先点左上角的分支下拉框选中你想下载的分支然后点击绿色的“Code”按钮菜单里选择“Download ZIP”浏览器就会下载一个压缩包解压后就是那个分支的最新代码。这个方式的优点是快、方便、不需要任何Git知识。缺点也很明显第一没有.git目录拿不到提交历史也就不是真正的Git仓库第二之后这个分支更新了你没法直接git pull同步只能重新下载一次压缩包第三如果你改动了代码也没法通过Git命令提交回远程。所以我的建议是临时参考代码用ZIP正经开发用命令不要混。3.5 四种方式如何选择把四种方式放一张表里对比大家按场景挑方式命令下载历史支持后续pull/push适合场景clone -bgit clone -b dev 地址默认全量支持明确知道分支名准备做开发clone全量再checkoutgit clone 地址 git checkout dev全量支持不知道有哪些分支想先看看fetch checkoutgit fetch origin git checkout -b dev origin/dev增量支持已有仓库需要拉取新分支网页下载ZIP浏览器操作无不支持临时查看不做后续开发如果非要我给一个“最佳实践”我的选择是日常开发用第一条git clone -b 分支名既能精确拿到目标分支又保留了完整仓库的灵活性后面想切到其他分支随时都可以。4. 分支下载之后的日常运维操作代码拉下来了分支也切过去了你以为就完了远远没有。分支下载只是开始后面查看状态、拉取更新、创建自己的开发分支、把dev分支合并到test分支这些才是每天都要面对的日常。我把这些高频操作串一遍。4.1 查看本地与远程分支的几条命令这个部分我直接整理成命令速查都是实际开发中反复用的# 查看本地分支当前分支前面会有*号 git branch # 查看远程分支 git branch -r # 查看本地和远程全部分支 git branch -a # 查看分支和远程跟踪关系 git branch -vv # 查看每个分支的最后一次提交 git branch -v再推荐一个命令git remote show origin它会显示远程仓库的详细信息包括本地分支与远程分支的跟踪关系以及哪些远程分支已经过时。git remote show origin输出里会列出一堆类似于dev tracked、main tracked的信息还能看到Local branches configured for git pull这类提示。排查分支同步问题时这个命令很好用。4.2 切换分支是checkout还是switch切换分支的命令我开头已经提过两个git checkout和git switch。不少人纠结该用哪个我的看法是新项目新习惯用git switch它是专门为“切换分支”这个动作设计的语义更清晰也不容易误用。老项目、老脚本里全是checkout那就继续用checkout完全没问题。常用的三种切换场景# 切换到已有本地分支 git switch dev # 基于某远程分支创建本地分支并切换 git switch -c dev origin/dev # 切回上一个分支相当于IDE里的AltTab git switch -切换分支有一个重要前提工作区必须是干净的。如果你本地有未提交的修改Git通常会阻止你切换避免这些修改被带到别的分支上。具体报错后面常见问题部分会详细讲。另外提一下“detached HEAD”中文叫“分离头指针”。如果你执行的是git checkout origin/dev而不是git checkout -b dev origin/devGit会告诉你HEAD指向了一个具体的提交而不是一个分支。这时候你的修改没有可以被引用的分支提交之后再想找回会比较麻烦。我见过不少新手在这上面吃亏所以特别提醒切远程分支一定要加-b创建本地分支别直接站在origin/dev上操作。4.3 拉取最新代码git pull 与 git fetch 的区别分支代码下载到本地后远程可能每天都在变。要同步远程的最新更新最常见的就是git pull。但很多人只知pull不知fetch这里把两者彻底讲清楚。git pull实际上等于git fetch origin加上git merge origin/当前分支。也就是说它先拉取远程更新然后立刻把更新合并到当前分支。表面看一步到位但有一个潜在问题如果你本地有未提交的修改或者本地提交和远程提交产生了分叉pull默认会生成一个merge commit历史记录里就会多出一条“Merge branch ...”的提交日志看起来不够干净。更平滑的做法是git pull --rebase这条命令的意思是以远程分支为基础把本地的独有提交“重放”到最新提交之上不产生多余的merge commit历史是一条直线。团队协作里我基本都用git pull --rebase。如果不想自动合并只看远程更新就手动fetchgit fetch origin git log origin/dev --oneline先看看远程分支新增了哪些提交再决定怎么合并。这样做的好处是控制力更强尤其适合在公共分支上操作时先了解远程动态再动手避免盲目合并引入冲突。不管用哪种方式原则是一样的在公共分支比如main、dev上pull之前先把自己的工作区清理干净该提交的提交该stash的stash。4.4 基于下载分支创建自己的开发分支你从GitHub拉下来的分支比如dev通常是团队公用的开发集成分支。不要在它上面直接改代码而是基于它创建自己的开发分支这样既能隔离改动又方便后续合并。git switch -c feature/登录模块 dev这个命令基于dev分支创建了一个叫feature/登录模块的新分支并切换过去。开发完成后常规操作是# 把改动加入暂存区 git add . # 提交-m后面写提交信息 git commit -m 完成登录模块开发 # 推送到远程-u参数会建立本地分支和远程分支的跟踪关系 git push -u origin feature/登录模块团队常见的“将dev分支代码合并到test分支”就是这样一个流程# 先切到test分支并更新到最新 git switch test git pull --rebase origin test # 把dev分支合并进来 git merge dev # 推送 git push origin test注意合并之前一定要确保本地dev已经是最新状态否则你合并的可能是旧代码。稳妥的流程是先切到dev拉取最新再切回test去合并。5. IDE和图形工具的下载切换实战命令行威力大但日常开发里大多数人还是习惯在IDE和图形工具里操作。这里把IDEA、VSCode、TortoiseGit三种常见工具的“下载并切换GitHub分支”操作讲清楚顺便解决几个网上问得特别多的问题。5.1 IDEA右下角分支菜单、Fetch与Rebasing处理IntelliJ IDEA右下角有一个很小的分支状态栏显示当前分支名点一下会弹出整个分支菜单。这个设计很隐蔽但用习惯了非常顺手。从GitHub下载某个分支在IDEA里的标准操作是打开项目确保已经配置了Git和远程仓库。点击菜单栏Git选择FetchIDEA会从远程拉取所有分支的最新引用。这一步很关键不Fetch的话新建的远程分支不会出现在列表里。点击右下角分支名在弹出的Branches窗口里展开Remote Branches找到目标远程分支。右键选择CheckoutIDEA会自动创建对应的本地分支并切换过去。如果有人问“用IDEA从GitHub拉取若依框架的分支怎么操作”流程完全一样先Fetch再看远程分支列表找到dev或其他分支Checkout即可。网上很多人在问“2024版本的IDEA右下角怎么不显示当前在哪个git分支了”。这个问题我遇到过是新版IDEA默认隐藏了状态栏上的Git Widget。解决办法是菜单View-Appearance-Status Bar Widgets把Git Branch勾选上右下角的分支信息就回来了。另一个热门问题“IDEA拉取git分支提示Rebasing”。这通常发生在执行pull且配置了rebase策略时如果有冲突IDEA会进入Rebasing状态卡在当前分支上等你去解决。菜单栏VCS-Git下面能看到两个选项Continue Rebasing和Abort Rebasing。如果冲突太多不想要这个操作了直接选Abort回到rebase之前的状态如果冲突已经解决完选Continue继续。频繁在多个分支之间切换强烈建议先把本地修改处理干净再切。IDEA提供了一个很方便的功能右键当前分支选择Stash Changes把未提交的修改暂时存起来等切完分支再Unstash Changes恢复这就避免了切换分支时的报错。5.2 VSCode左下角分支切换与远程分支清理VSCode的分支操作入口在左下角点击当前分支名会弹出一个命令面板列出所有本地分支和远程分支。切换分支直接在列表里点就行也可以在命令面板里输入分支名模糊搜索。如果你在GitHub上新建了一个分支VSCode里看不到处理方法跟IDEA一样先拉取远程引用。在命令面板输入Git: Fetch执行完再刷新分支列表新分支就会出现在Remote分支里。VSCode里基于远程分支创建本地分支也很简单在命令面板选择Git: Checkout to然后选择远端分支VSCode会弹出提示问你是否要创建本地分支并切换确认即可。VSCode里有个很多人没发现的功能同步按钮。源代码管理面板左上角有一个“同步更改”图标点击相当于执行了git pull加git push一键把当前分支的远程更新拉下来再推上去。对于只会用界面操作的同学来说非常省心。“vscode清理删除的分支”是最近问得多的一个点。你和别人协作时对方在GitHub上删掉了一个分支但你本地还留着对应的origin/xxx引用每次刷新分支列表都觉得碍眼。解决办法是在终端执行一条命令git fetch --prune--prune参数会在fetch时自动清理本地已经不存在的远程分支引用。5.3 TortoiseGit右键完成克隆与切换用过SVN的人对TortoiseSVN应该不陌生TortoiseGit就是它的Git版本Windows下安装后在文件夹里右键就能看到一堆Git相关的菜单项中文名叫“小乌龟”。用TortoiseGit从GitHub下载指定分支的步骤在你要保存代码的文件夹空白处右键选择Git Clone。URL填写GitHub仓库地址。如果明确要某个分支在Branch一栏直接填分支名这样clone完成之后直接处于目标分支不填则默认检出主分支。点击OK等待克隆完成。克隆完成后切换分支在仓库文件夹右键选择Switch/Checkout弹出窗口里会列出本地分支和远程分支选择目标分支后点OK。如果选择的是远程分支TortoiseGit会先自动创建对应的本地分支。拉取远程更新右键菜单里选Fetch弹出窗口可以直接Fetch全部分支。Fetch之后再通过Switch/Checkout切换到最新代码。也可以在右键菜单里用Pull直接拉取并合并。对于不习惯命令行的人TortoiseGit的图形化体验非常友好提交、合并、冲突解决都有可视化界面。但底层操作依然是Git命令如果遇到它搞不定的疑难杂症还是要回到命令行去排查。6. 常见问题与排查技巧实录这部分是我实际工作中被问得最多的问题汇总也是“最详细”成色的关键所在。这些问题网上东一条西一条我今天统一整理成一个速查板块配合排查思路一起讲大家以后遇到直接对号入座。6.1 HTTPS克隆提示认证失败怎么办用HTTPS地址克隆仓库时Git提示输入用户名和密码输入GitHub登录密码后却报Authentication failed或Support for password authentication was removed这是GitHub在2021年8月之后正式停用密码认证导致的。解决办法有两个第一个是用Personal Access Token也就是个人访问令牌。生成路径GitHub头像 - Settings - Developer settings - Personal access tokens - Tokens (classic) - Generate new token。生成时至少勾选repo权限复制生成的token克隆时密码一栏粘贴这个token而不是登录密码。第二个是一劳永逸的方案改用SSH。具体的密钥生成和配置方法我在前面1.3节已经写过这里不再重复。我的经验是不要为了图省事把token直接写进克隆地址例如git clone https://tokengithub.com/user/repo.git。虽然能用但token会明文保存在历史记录里一旦泄露别人就能直接操作你的仓库。正确做法是正常克隆让Git提示时输入用户名和tokenWindows凭据管理器会自动保存下次不会再问。6.2 明明有远程分支本地却看不到很多人遇到的情况是在GitHub网页上能看到dev分支但本地git branch -a里就是没有origin/dev。原因几乎都是没有fetch。Git clone完成时确实会把所有远程分支引用拉下来。但如果别人之后又新建了分支而你的本地仓库一直没做任何同步操作自然不会出现这个新分支。解决办法很简单git fetch origin执行完再git branch -a新分支就出现了。如果分支显示为origin/dev但本地没有对应的dev分支用git checkout -b dev origin/dev或git switch -c dev origin/dev创建本地分支并切换。一个排查小技巧先看远程仓库里到底有没有这个分支执行git ls-remote --heads origin这个命令直接向远程询问所有分支的HEAD引用不依赖本地缓存。如果这里能看到目标分支但本地看不到那就是fetch或引用缓存的问题如果这里都看不到说明分支在服务端压根不存在或者你拉取地址不是同一个仓库。6.3 切换分支提示pathspec不匹配执行git checkout dev时报错error: pathspec dev did not match any file(s) known to git这个报错有两个可能第一你手滑打错了分支名第二本地确实没有这个分支而且Git也没有自动从远程创建。后者更常见。我建议的排查顺序是# 看看本地分支 git branch # 看看远程分支 git branch -r如果远程有origin/dev本地没有就手动创建并跟踪git checkout -b dev origin/dev如果你用的是新版Git理论上直接git checkout dev会自动创建但自动创建有一个前提本地没有任何与dev同名的目录或文件。如果当前目录下恰好有一个叫dev的文件夹Git会把dev解析为路径而不是分支名于是报pathspec错误。这种情况把目录改个名或者用git checkout --track origin/dev强制指定远程分支来源。6.4 本地修改未提交导致切换失败切换分支时报error: Your local changes to the following files would be overwritten by checkout意思是当前分支有未提交的修改和要切换的目标分支冲突了Git不敢贸然覆盖。这时候处理方案有三个第一个是最常用的把修改暂时藏起来切完再拿出来git stash git switch dev git stash popgit stash pop恢复正常后如果和目标分支的代码冲突Git会进入冲突状态需要手动解决冲突文件解决完再git add提交。如果你只是想保存修改但目标分支的代码已经包含了这个改动直接丢弃暂存内容git stash drop第二个方案是直接把修改提交到当前分支再切换。适合修改已经是一个完整功能的情况。第三个方案是放弃修改这个要万分谨慎git checkout -- 文件名 git reset --hard HEAD这两条命令会永久丢弃本地未提交的修改。我见过太多新手图省事执行reset --hard把写了一天一夜的代码直接抹掉再也没有找回来。除非你确定这些改动不要了否则千万别用。6.5 GitHub访问不稳定时的应对GitHub作为海外站点国内访问偶尔确实会出现加载慢、下载断断续续的情况。这个问题的本质是网络链路问题和Git命令本身的配置关系不大。我的实际经验是可以先换一个网络环境试试手机热点、公司网络、不同运营商的宽带经常能解决大部分问题。再一个就是错峰操作避开晚高峰时段。对于代码下载来说有一个切实有效的思路优先用浅克隆减少数据量。比如你只要某个分支的最新代码别全量clone直接git clone -b dev --depth 1 https://github.com/你的用户名/仓库名.git只下载最近一条提交体积可能小十倍以上成功率会高很多。下载完成后如果后续需要完整历史补一条git fetch --unshallow就行。还有一个小技巧如果clone大仓库时总在某个文件卡住可以调大HTTP缓冲区避免大文件传输超时git config --global http.postBuffer 524288000这个参数把缓冲区调到500MB主要用于解决HTTPS协议下大文件push或clone失败的问题。注意这是正常的Git配置项和任何第三方工具没有关系。还有一种非常现实的办法让网络条件好的同事先clone好再通过U盘、网盘这些方式把完整仓库目录拷给你。Git仓库目录本身是可以整体拷贝的只要包含.git文件夹拷到任何电脑上都能正常使用这也算一种合法的离线分发方式。6.6 下载到一半断了怎么续传git clone或者git fetch执行到一半网络断了或者手动CtrlC中断了这种情况我遇到太多次了。很多人第一反应是删掉刚才下载的目录重新clone其实完全不用。Git的设计中有对象复用机制。你中断之后已经下载的对象会保存在.git/objects目录里重新执行同一条clone或fetch命令时Git会复用已有的对象只下载缺失的部分相当于天然支持断点续传。所以正确的做法是直接再执行一次原来的clone命令如果提示目录已存在且不是空目录就进入该目录使用git fetch origin先把远程所有分支引用拉完整再切换分支。实测下来重复执行往往比第一次更快因为大部分对象已经在本地了。如果仓库实在太大经常断流就用浅克隆先保底git clone -b dev --depth 1 https://github.com/你的用户名/仓库名.git拿到代码再说历史记录后面慢慢补。6.7 IDEA拉取时一直卡在Rebasing关于Rebasing的问题前面第五部分简单提过这里再深入讲一下因为这个状态实在太容易吓到人了。事情通常是这样的你在IDEA里执行了PullIDEA按git pull --rebase的逻辑操作把当前分支的本地提交往后重放。这个过程中如果出现代码冲突Rebasing就被挂起IDEA会进入一个“半完成”状态分支菜单里一直显示Rebasing此时Git不允许你做其他分支操作。看到这个状态不用慌按这个顺序排查第一步先看Git菜单下有哪些可用选项。如果有Continue Rebasing说明冲突已解决待确认如果有Abort Rebasing说明可以随时中止。第二步如果冲突没解决完打开冲突文件逐个处理。IDEA里冲突文件会以红色显示使用Merge工具可以直接可视化合并两边代码。第三步全部解决后回到VCS-Git-Continue Rebasingrebase会自动继续完成后分支状态恢复正常。如果你完全不想处理了直接Abort Rebasing中止rebase当前分支会回到rebase之前的状态可以重新规划。在命令行里对应的操作是git rebase --continue git rebase --abort6.8 分支异常清理与常用问题速查表最后把高频问题汇总成一张速查表方便收藏和快速定位。症状可能原因解决办法clone提示Authentication failed使用GitHub密码认证已停用改用Personal Access Token或SSH密钥本地看不到远程新分支未fetchgit fetch origin再查 git branch -rcheckout dev提示pathspec不匹配分支不存在或误识别为路径git checkout -b dev origin/dev切换分支提示local changes overwritten本地有未提交修改冲突git stash暂存切换后git stash poppull操作一直在Rebasing状态rebase过程中遇到冲突解决冲突后continue或abort中止远程分支已删除本地还有残留远程引用未清理git fetch --pruneclone总是断流失败网络不稳定或仓库过大用--depth 1浅克隆或换网络再试IDEA右下角不显示分支名新版本隐藏了Git WidgetView - Appearance - Status Bar Widgets勾选Git Branchfetch后本地没有跟踪分支只拉了引用没建本地分支git branch --track dev origin/dev排查思路其实就一条先分清楚问题在哪一层。仓库地址能不能通、远程有没有这个分支、本地有没有创建跟踪分支、工作区干不干净一层一层查下去百分之九十的问题都能自己定位。最后再分享一个我个人的习惯在公司的开发机上我会把pull.rebase默认设置为true同时配置两个常用别名分别是git cocheckout简写和git brbranch简写git config --global pull.rebase true git config --global alias.co checkout git config --global alias.br branch git config --global alias.st status git config --global alias.lg log --graph --prettyformat:%h -%d %s (%cr) --abbrev-commit带团队这几年我见过太多人在分支下载和切换上栽跟头追根溯源还是对“分支只是一个指针”这个底层概念没建立起来。你把这点想通了再配合今天这套命令和工具操作GitHub分支下载这件事基本不会再难住你。代码拉下来、分支切过去剩下的就是安心写代码了。