Git 从零到远程协作实战指南

初始化本地仓库

# 创建项目目录并进入
mkdir my_project
cd my_project

# 初始化Git仓库
git init

# 创建基础文件（如README）
echo "# My Project" >> README.md

基础配置与首次提交

# 设置用户信息（全局配置可加 --global）
git config user.name "Your Name"
git config user.email "your.email@example.com"

# 查看当前状态
git status

# 添加文件到暂存区
git add README.md

# 提交到本地仓库
git commit -m "Initial commit"

连接远程仓库（以GitHub为例）

# 在GitHub创建新仓库后，关联远程仓库
git remote add origin https://github.com/yourusername/yourrepository.git

# 验证远程仓库
git remote -v

# 首次推送（-u参数设置上游分支）
git push -u origin main

分支协作流程

# 创建新功能分支
git checkout -b feature/login

# 在新分支上开发并提交
echo "Login page code" >> login.html
git add login.html
git commit -m "Add login page"

# 切换回主分支
git checkout main

# 合并功能分支
git merge feature/login

# 推送更新到远程
git push origin main

处理远程变更

# 拉取远程最新代码（等价于 fetch + merge）
git pull origin main

# 当出现冲突时，手动解决后执行
git add resolved_file.txt
git commit -m "Resolve merge conflict"

常用协作命令

# 查看提交历史（含分支图）
git log --graph --oneline --all

# 撤销本地修改（未add的文件）
git checkout -- filename.txt

# 撤销已add的文件
git reset HEAD filename.txt

# 创建标签并推送
git tag v1.0
git push origin v1.0

其他实用技巧

# 储藏当前工作（临时切换分支时使用）
git stash

# 恢复储藏内容
git stash pop

# 强制同步远程分支（危险操作）
git fetch origin
git reset --hard origin/main

多人协作注意事项

• 每次开始工作前先执行 git pull
• 功能开发尽量在新分支完成
• 合并前使用 git diff 检查变更
• 定期清理已合并的分支 git branch -d branchname

所有代码块均可直接复制到终端执行，需根据实际项目替换仓库地址、文件名等参数。对于首次使用的用户，建议先在测试仓库练习这些命令。

Git 基础概念

Git 是一个分布式版本控制系统，用于跟踪文件变化并协调多人协作开发。核心概念包括：

• 仓库（Repository）：存储项目历史记录和元数据的目录
• 提交（Commit）：记录文件在某个时间点的快照
• 分支（Branch）：独立开发线，默认主分支为main或master
• 远程（Remote）：托管在服务器上的仓库副本

本地仓库初始化

在项目目录执行以下命令初始化本地仓库：

git init

创建.gitignore文件排除不需要版本控制的文件：

touch .gitignore

添加文件到暂存区并提交：

git add .
git commit -m "Initial commit"

分支管理

创建新分支并切换：

git checkout -b feature-branch

查看当前分支状态：

git status

合并分支到主分支：

git checkout main
git merge feature-branch

远程协作配置

添加远程仓库地址（以GitHub为例）：

git remote add origin https://github.com/username/repo.git

首次推送本地分支：

git push -u origin main

拉取远程更新：

git pull origin main

解决代码冲突

当多人修改同一文件时可能出现冲突。执行git pull后，冲突文件会包含标记：

<<<<<<< HEAD
本地修改内容
=======
远程修改内容
>>>>>>> commit-hash

手动编辑文件保留需要的内容，删除标记后重新提交：

git add conflicted-file.txt
git commit -m "Resolve merge conflict"

常用工作流程

功能开发流程：

1. 从主分支创建新功能分支
2. 在功能分支上开发并提交
3. 推送分支到远程仓库
4. 创建Pull Request请求合并
5. 通过代码审查后合并到主分支

紧急修复流程：

git stash
git checkout main
git pull origin main
git checkout -b hotfix-branch
# 进行修复并提交
git push origin hotfix-branch

高级技巧

修改最近一次提交：

git commit --amend

查看提交历史：

git log --graph --oneline

撤销工作区修改：

git checkout -- file.txt

临时保存未完成工作：

git stash
git stash pop

团队协作规范建议

• 保持主分支始终可部署
• 使用有意义的提交信息
• 定期从主分支拉取更新
• 通过Pull Request进行代码审查
• 一个功能对应一个分支
• 测试通过后再合并到主分支

Git基础概念

• 版本控制的定义与作用
• Git与其他版本控制工具的区别
• Git核心术语：仓库、提交、分支、HEAD

本地Git环境搭建

• 安装Git（Windows/macOS/Linux）
• 配置全局用户信息（git config --global）
• 初始化仓库（git init）与克隆（git clone）

基础操作与版本管理

• 文件状态生命周期（未跟踪/已修改/已暂存）
• 常用命令：git add、git commit、git status、git log
• 撤销操作：git restore、git reset、git checkout

分支管理与协作策略

• 创建与切换分支（git branch、git switch）
• 合并与冲突解决（git merge、手动处理冲突）
• 分支策略推荐（主分支/开发分支/功能分支）

远程仓库协作实战

• 关联远程仓库（git remote add）
• 推送与拉取（git push、git pull）
• 协作流程：Fork + Pull Request（以GitHub为例）

高级技巧与工具

• 暂存更改（git stash）
• 标签管理（git tag）
• 可视化工具推荐（SourceTree、GitKraken）

常见问题排查

• 典型错误场景（提交到错误分支、冲突处理失败）
• 恢复丢失的提交（git reflog）
• 强制推送的风险与规范

实战项目演练

• 模拟团队协作：从本地开发到代码审核的全流程
• 开源项目贡献指南（CLA签署、Issue提交规范）

延伸学习资源

• Git官方文档与Pro Git电子书
• 交互式学习平台（如Learn Git Branching）
• 社区推荐（Stack Overflow、GitHub Discussions）

Git从零到远程协作：手把手实战指南

通过搜索整理，以下是与Git从零到远程协作相关的中文实战指南资源，涵盖书籍、在线教程和视频课程：

书籍推荐

《Git版本控制管理（第2版）》

• 作者：Jon Loeliger
• 内容：从基础概念到高级操作，包括分支管理、远程仓库协作等，适合系统学习。

《Pro Git》中文版（免费在线阅读）

• 作者：Scott Chacon
• 官网：https://git-scm.com/book/zh/v2
• 内容：Git官方推荐教程，涵盖从安装到团队协作的全流程。

在线教程

廖雪峰的Git教程

• 网址：https://www.liaoxuefeng.com/wiki/896043488029600
• 特点：以实战案例驱动，包含本地仓库操作、GitHub远程协作及分支管理。

菜鸟教程-Git篇

• 网址：https://www.runoob.com/git/git-tutorial.html
• 特点：分步骤图解，适合快速入门和查询常用命令。

视频课程

B站《Git与GitHub实战教程》

• UP主：程序员鱼皮
• 链接：https://www.bilibili.com/video/BV1KU4y1Z7Lg
• 内容：演示从零配置到团队协作开发的全流程。

慕课网《Git系统精讲》

• 网址：https://www.imooc.com/learn/1278
• 特点：结合图形化工具讲解，适合视觉化学习者。

实战要点

本地仓库初始化与提交

git init  
git add .  
git commit -m "初始提交"

远程仓库协作（以GitHub为例）

git remote add origin https://github.com/username/repo.git  
git push -u origin main

分支管理与合并

git checkout -b feature  
git push origin feature  
git merge feature

注意事项

• 团队协作时建议使用pull request进行代码审查。
• 频繁使用git status查看当前状态。
• 冲突解决优先使用图形化工具（如VSCode内置的Git工具）。

以上资源可帮助快速掌握Git核心操作，建议结合实践项目巩固学习。