Git最佳实践指南（Windows/Linux双系统详解）

Git最佳实践指南：从入门到熟练（Windows/Linux双系统详解）

一、环境搭建与基础配置（适用Windows/Linux）

1.1 Git安装与验证

# Windows系统安装（推荐Chocolatey包管理）
# 直接下载git二进制文件安装包更方便
choco install git

# Linux系统安装（Debian系）
sudo apt-get update && sudo apt-get install git

# 验证安装
git --version

安装教程参考：CSDN《Windows系统Git安装教程》1、《Linux源码安装Git》1

1.2 全局身份配置

# 设置全局用户名（建议与代码托管平台一致）
git config --global user.name "YourName"
git config --global user.email "your_email@example.com"

# 查看配置
git config --list

身份信息会永久记录在提交历史中2

1.3 SSH密钥生成（团队协作必备）

# 生成RSA密钥对（两系统通用）
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

# Windows默认存储路径：
# C:\Users\用户名\.ssh\id_rsa.pub

# Linux默认存储路径：
# ~/.ssh/id_rsa.pub

将公钥添加到GitHub/GitLab的SSH Keys设置中6

---

1.4 分支策略规划矩阵

分支类型	创建方式	生命周期	典型命名
develop	主开发分支	永久	develop
feature	git checkout -b feature/xxx	短期	feature/login
hotfix	git checkout -b hotfix/xxx	短期	hotfix/payment
release	git checkout -b release/v1.0	中期	release/v1.0

1.5 分支策略矩阵

分支类型	生命周期	操作权限	典型命名
main	永久	只读	main/master
release	短期	只读	release/v1.0
hotfix	短期	开发	hotfix/login
feature	中期	开发	feature/pay

1.6 文件状态管理说明

状态	查看命令	转换操作
未跟踪	git status红色	git add <file>
已暂存	git status绿色	git restore --staged
已提交	git log	git commit --amend

1.7 Git三区工作原理11

1.7.1 三区对应命令

工作区	暂存区	版本库
git add	git commit	git push
git restore	git reset	git tag
文件修改可见	临时存储区	历史版本存储

1.7.2 状态转换示例

# 从工作区到暂存区
git add main.py

# 从暂存区撤回
git restore --staged main.py

# 提交到版本库
git commit -m "新增核心模块"

---

二、新项目启动标准流程（团队协作版）12

（注：三个核心工作区说明详见附录）

2.1 初始化仓库（组长操作）

# 创建主仓库（GitLab/GitHub新建仓库）
# 设置默认分支为develop
git init --initial-branch=develop

# 创建并切换分支（推荐）

git checkout -b feature/login

# 查看分支拓扑图
git log --graph --oneline --all

# 合并分支（保留提交历史）
git checkout main
git merge feature/login

# 变基操作（线性历史）
git checkout feature/login
git rebase main

变基前必须确保分支未推送到远程3

2.2、仓库管理关键操作（组长）

2.2.1 本地仓库改名（跨平台方案）34

# Windows系统
ren old_project new_project
cd new_project
git remote set-url origin new_repo_url

# Linux系统
mv old_project new_project
cd new_project
git remote set-url origin git@newhost:user/new_project.git

2.2.2 远程仓库改名（需权限）

# 托管平台操作（以GitHub为例）：
1. Settings -> Repository name修改
2. 本地同步：
git remote set-url origin git@github.com:user/new_name.git 

2.2.3 修改远程关联（三种方法）910

# 方法一：直接修改（推荐）
git remote set-url origin git@newhost.com:user/repo.git

# 方法二：先删后加
git remote rm origin
git remote add origin git@newhost.com:user/repo.git

# 方法三：编辑配置文件
vi .git/config  # 修改[remote "origin"]下的url

2.3 成员协作配置

# 成员操作（以Linux为例）
# 本地初始化（适合新项目）
mkdir project && cd project
git init

#已有项目
cd devRoot
git clone git@gitlab.com:group/project.git   # 克隆主仓库
cd project
git remote rename origin upstream            # 重命名主仓库引用
git remote add origin git@gitlab.com:user/project.git  # 添加个人仓库
git push -u origin develop                   # 推送本地分支

2.3.1 代码暂存与恢复

# 暂存当前修改（紧急切换分支时）
git stash push -m "暂存登录模块修改"

# 查看暂存列表
git stash list

# 恢复最近暂存
git stash pop

# 选择性恢复
git stash apply stash@{2}

2.4 冲突解决四步法

1. 定位冲突文件：git status显示冲突文件
2. 使用IDE工具合并（VSCode/GitKraken）
3. 手动编辑标记区（保留需要的代码）
4. 标记解决完成：

git add resolved_file
git commit -m "解决登录模块冲突"

三、版本控制进阶技巧

3.1 历史操作追溯

# 查看精简历史
git log --oneline -n 5

# 文件修改追溯
git blame src/main.js

# 差异对比（跨分支）
git diff main..feature/pay --stat

3.2 版本回滚策略

# 软回退（保留修改）
git reset --soft HEAD~1

# 硬回退（慎用）
git reset --hard a1b2c3d

# 恢复误删提交
git reflog
git checkout lost_commit_hash

---

四、跨平台操作差异处理

4.1 换行符统一方案

# 全局设置（推荐）
git config --global core.autocrlf input  # Linux/Mac
git config --global core.autocrlf true   # Windows

# 修复现有仓库
git rm --cached -r .
git reset --hard

4.2 路径处理规范

# Windows路径处理（转义特殊字符）
git add "src/modules/new\ feature"

# Linux路径处理
git add src/modules/new_feature

---

五、最佳实践清单

5.1 提交规范（参考Angular标准）

git commit -m "feat(login): 增加短信验证码登录功能

- 实现短信平台对接
- 添加频率限制功能
- 完善错误处理逻辑

Closes #123"

类型说明：feat/fix/docs/style/refactor/test3

5.2 每日工作流模板19

5.2.1 早间同步

# 早间同步
# 拉取最新代码（推荐变基方式）
git fetch upstream
git rebase upstream/develop
git fetch --all --prune
git rebase origin/main

5.2.2 功能开发流程

# 创建功能分支，开发过程
git checkout -b feature/user-auth

# ... coding ...增加新功能
# 开发完成后提交
git add .
git commit -m "feat(auth): 增加JWT认证模块 "
git push origin HEAD:feature/user-auth

# 解决冲突后提交
git add .
git rebase --continue

5.2.3 晚间清理操作

# 晚间推送
# 创建合并请求（MR/PR）
git push origin feature/xxx

# 删除已合并分支
git branch --merged | grep -v '\*\|develop' | xargs -n 1 git branch -d

# 清理远程引用
git remote prune origin

---

六、高频问题解决方案

6.1 分支误删恢复

# 查找丢失的提交
git reflog
# 恢复分支
git checkout -b recovered-branch commit_hash

# 基于main创建热修复分支
git checkout -b hotfix/payment main

# 提交修复代码
git commit -m "fix(pay): 修复金额计算精度问题"

# 合并到main和develop
git checkout main
git merge --no-ff hotfix/payment
git checkout develop
git merge --no-ff hotfix/payment

6.2 清理历史大文件

# 查找大文件
git rev-list --objects --all | grep "$(git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n | tail -5 | awk '{print$1}')"

# 使用BFG清理
java -jar bfg.jar --strip-blobs-bigger-than 100M
git reflog expire --expire=now --all
git gc --prune=now --aggressive

---

七、可视化工具推荐

7.1 工具对比表

工具	适用场景	跨平台	学习曲线
GitKraken	复杂分支管理	✔️	中等
SourceTree	日常操作	✔️	简单
VS Code GitLens	代码追溯	✔️	低
TortoiseGit	文件状态可视化	Windows	低

推荐组合：VS Code + GitLens插件3

八、持续学习资源推荐

1. 官方文档：git help <command>
2. 图解Git：https://marklodato.github.io/visual-git-guide
3. 交互式学习：https://learngitbranching.js.org
4. 进阶书籍：《Pro Git》（免费电子版）35
5. 安装git,关于git的一切及vs code 跟git的结合在上面链接中说得很明白。

本指南综合Git核心原理与工程实践经验，覆盖95%日常开发场景。建议配合实际项目演练掌握各项技能，遇到特殊问题时可查阅对应章节的解决方案。

## 附录：进阶操作速查表

| 操作类型         | Windows命令示例              | Linux命令示例               |
|------------------|------------------------------|-----------------------------|
| 分支重命名       | git branch -m old new        | git branch -m old new       |
| 查看远程URL      | git remote -v                | git remote -v               |
| 修改提交信息      | git commit --amend           | git commit --amend          |
| 差异比较          | git diff HEAD^               | git diff HEAD^              |

> 本指南整合Git核心原理与工程实践，覆盖项目全生命周期操作。建议结合可视化工具（如VS Code GitLens）提升操作效率，遇到特殊问题时优先使用`git reflog`追溯操作历史。