NewbeeSmart每天都在接触 Git 的团队，几乎没人能绕过 git clone。哪怕你已经熟练使用提交和推送，我第一次从压缩包工作流切到 Git 协作时，也是在 clone 这一步卡了整整一晚上：协议选哪个、分支为什么只有一条、克隆到一半报错怎么办。后来带过几个新人，发现大家踩的坑其实高度相似。这篇东西就按我从 0 到团队实战的顺序来写，把安装、配置、协议选择、常用参数、协作循环以及高频报错的完整排查链路都过一遍。不管你是刚装好 Git 的初学者，还是要给团队写内部文档的老手，照着走基本不会踩坑。
1. 为什么团队协作的第一步永远是 git clone
1.1 拿到既有仓库的三种方式，差别在哪儿
我见过很多刚接触 Git 的同学，还停留在“下载源码压缩包”的思路上：去网页点 Download ZIP，解压完再手动 git init，然后把远程地址 git remote add origin ...。这套流程确实能跑通，但它的问题很直接——你拿到的只是一个“代码快照”，不是一条完整的“开发历史”。
一个正规的远程仓库，至少包含三层东西：
- 当前工作区的文件内容
- 全部提交历史（每一次谁改了什么、为什么改）
- 全部分支、标签等引用信息
git clone 的作用，就是把这三层一次性复制到本地。压缩包只给了第一层，它不包含 .git 目录，所以无法查提交记录、切分支、对比变更。你当然可以手动补齐另外两层，但与其从零搭建本地仓库，不如直接用 git clone，这是成本最低、出错最少的方式。
1.2 Clone 之后本地仓库发生了什么
很多新人第一次 clone 完，看到 ls 出来的文件和远程一样，就以为“哦，就是把文件下载下来了”。其实更关键的动作发生在 .git 目录里。
执行 git clone https://github.com/example/example-repo.git 后，Git 会做三件事：
- 自动创建一个与仓库同名的目录（本例是
example-repo） - 在目录里执行
git init，初始化一个空白仓库 - 把远程地址保存为默认远程，命名为
origin，然后拉取默认分支的最新代码并 checkout 出来
对于“为什么本地只有 main 分支”这个问题，很多教程含糊带过。实际上，clone 会把远程的所有分支都同步到本地的“远程跟踪分支”里，只是没有为它们创建同名的本地分支。你可以用 git branch -r 看到类似 origin/develop、origin/feature/login 这样的列表。想切换到某个远程分支时，Git 通常会基于同名远程分支自动创建一个本地分支来跟踪它。
code复制git branch -r
git switch develop
第二条命令会提示 branch 'develop' set up to track 'origin/develop'，这就意味着你已经进入了正常的协作状态。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 装好 Git 只是开始：配置阶段最容易埋坑的地方
2.1 安装过程与终端选型
Windows 用户最常犯的错误，是从不明渠道下载到旧版本。建议直接去 Git 官网下载最新版，或者用包管理器安装，比如 winget install --id Git.Git -e。千万不要一路“Next”就不管了。安装过程中有几个选项需要留意，尤其是默认编辑器。如果你不想被迫用 Vim 写提交信息，提前在安装向导里把默认编辑器改成 VS Code 或 Notepad++，不然后面 commit 时卡在 Vim 里会很崩溃。
Linux/macOS 用户也有自己的问题。macOS 自带 Git 通常是老版本，执行 git --version 看到 2.20 以下的老古董时，建议通过 Homebrew 安装新版。Linux 则推荐用发行版自带的包管理器，例如 Ubuntu 上执行 sudo apt install git。
安装完成后，第一件事是打开终端执行 git --version，确认能正常输出版本号。Windows 我建议直接用 Git Bash，而不是 CMD 或 PowerShell。这不是情怀问题，而是 Git Bash 会帮你把 /c/Users/xxx 这类路径、换行符和一些 shell 行为处理好，减少大量跨平台头疼问题。
2.2 先设置 user.name 和 user.email
不带身份信息的 Git 是没法提交的。这里有一个经常被忽略的细节：提交记录里显示的作者信息，不是你的登录用户名，而是 user.name 和 user.email 这两个配置项决定的。
code复制git config --global user.name "你的名字"
git config --global user.email "you@example.com"
团队协作时，建议设置成和代码平台账号一致的信息。否则提交记录里挂着一个陌生的邮箱，代码评审的人想 @ 你都找不到人。还有一个常见诉求：公司要求某些仓库必须用公司邮箱提交，个人项目用私人邮箱。这种场景就不要用 --global，而是进入对应仓库目录后去掉 --global 重新设置，让仓库级配置覆盖全局配置。
2.3 换行符与凭据管理，团队协作的两个隐形冲突源
Windows 与 Linux/macOS 的换行符不同。Wi