从零开始的Git实战指南：本地仓库到团队协作全流程
标签：Git · 开发工具 · 版本控制 · 团队协作
分类：开发工具
摘要：从本地建仓库、推送GitHub、多人协作到分支管理，一篇覆盖Git日常开发的完整流程，适合刚开始接触版本控制的同学。
前言
刚开始学Git的时候，最大的困惑是：命令很多，但不知道哪些是核心、哪些是偶尔才用的。
这篇文章是我自己整理的实战笔记，按照真实的工作流程来写，分为三个部分：
- 在本地创建仓库并推送到 GitHub
- 多人协作与分支管理
- 参与别人的开源项目
每一步都可以跟着做，随时用 git status 检查自己的状态。
一、从零创建本地仓库并推送到 GitHub
1. 初始化本地仓库
# 创建并进入项目文件夹
mkdir my-project
cd my-project
# 创建文件
touch README.md
# 初始化 Git 仓库
git init
执行 git init 后，当前文件夹就变成了一个 Git 仓库，会生成一个隐藏的 .git 目录来跟踪所有变更。
2. 查看仓库状态
git status
git status 是你最常用的命令，它会告诉你：
- 当前在哪个分支
- 哪些文件有改动但还没提交
- 哪些文件是新增的
养成习惯：每做一步操作，都用 git status 看看状态。
3. 暂存并提交文件
# 把文件添加到暂存区（准备提交的区域）
git add README.md
# 也可以一次性添加所有改动
git add .
# 提交，-m 后面写本次提交的说明
git commit -m "初始化项目，添加 README"
commit message 要写清楚"做了什么"，方便以后回看历史记录。比如：
- ✅
修复用户登录时的空指针异常 - ✅
添加矩阵乘法的单元测试 - ❌
改了一些东西
4. 连接远程仓库并推送
在 GitHub 上创建一个新的 Repository（不要勾选初始化 README，因为本地已经有了），然后：
# 把本地仓库和远程仓库关联起来
git remote add origin https://github.com/你的用户名/my-project.git
# 推送到远程仓库的 master 分支
git push origin master
到这里，你的代码就已经在 GitHub 上了。
二、分支管理与多人协作
在团队协作中，大家不会直接在 main 分支上改代码，而是每个人创建自己的分支，开发完成后再合并回主分支。
1. 创建并切换分支
# 创建新分支
git branch feature/add-login
# 切换到这个分支
git checkout feature/add-login
# 上面两步可以合并为一步
git checkout -b feature/add-login
2. 查看所有分支
# 查看本地和远程的所有分支
git branch -a
当前所在的分支前面会有一个 * 标记。
3. 在分支上开发并提交
# 修改文件后，查看改了什么
git diff
# 暂存 + 提交
git add .
git commit -m "添加用户登录功能"
# 把本地分支推送到远程
git push origin feature/add-login
4. 发起 Pull Request
推送到远程分支后，在 GitHub 上会看到提示，点击 Compare & pull request，然后点击 Create pull request。
PR 界面里可以点击 Files changed 查看这次改动的具体内容，团队成员可以在这里进行代码审查（Code Review）。
确认无误后，合并到 main 分支即可。
三、参与别人的项目
1. 克隆远程仓库到本地
# 把别人的项目下载到本地
git clone https://github.com/其他用户/项目名.git
# 进入项目目录
cd 项目名
2. 创建自己的开发分支
不要直接在 main 分支上改代码：
git checkout -b fix/typo-in-readme
3. 修改、提交、推送
git add .
git commit -m "修复 README 中的错别字"
git push origin fix/typo-in-readme
4. 拉取最新代码
当项目有更新时，需要同步最新的代码：
# 切换到主分支
git checkout main
# 拉取远程最新更改
git pull
# 把远程的更改合并到本地的开发分支
git checkout fix/typo-in-readme
git merge origin/main
四、常用命令速查表
| 命令 | 作用 |
|---|---|
git init | 初始化本地仓库 |
git status | 查看当前仓库状态 |
git add <文件> | 把文件加入暂存区 |
git commit -m "说明" | 提交暂存区的改动 |
git push origin <分支名> | 推送到远程仓库 |
git pull | 拉取远程最新代码 |
git branch -a | 查看所有分支 |
git checkout -b <分支名> | 创建并切换到新分支 |
git clone <链接> | 克隆远程仓库 |
git diff | 查看具体改动内容 |
git merge origin/<分支名> | 合并远程分支到本地 |
总结
Git 的核心工作流其实就三件事：
- 改代码 →
git add→git commit - 同步远程 →
git push/git pull - 多人协作 → 分支 → Pull Request → 合并
刚开始不需要记住所有命令，先把这个主流程跑通，遇到问题再查。git status 是你最好的朋友，随时告诉你下一步该做什么。
如果这篇文章对你有帮助，欢迎点赞收藏～后续会继续更新 Git 进阶用法，包括 rebase、cherry-pick、冲突解决等内容。
