Git 版本控制与工作流程

工作区 (Working Directory)
    ↓ git add
暂存区 (Staging Area)
    ↓ git commit
版本库 (Repository)
    ↓ git push
远程仓库 (Remote Repository)

# 初始化新仓库
git init

# 克隆远程仓库
git clone https://github.com/user/repo.git
git clone git@github.com:user/repo.git

# 查看仓库状态
git status
git status -s  # 简洁输出

# 添加文件到暂存区
git add file.txt
git add .                    # 添加所有文件
git add *.js                 # 添加所有 js 文件
git add -A                   # 添加所有变更

# 提交更改
git commit -m "提交信息"
git commit -am "添加并提交"   # 跳过暂存区

# 查看提交历史
git log
git log --oneline           # 简洁格式
git log --graph             # 图形化显示
git log --author="张三"      # 按作者筛选

# 撤销工作区修改
git checkout -- file.txt
git restore file.txt        # Git 2.23+

# 撤销暂存区修改
git reset HEAD file.txt
git restore --staged file.txt  # Git 2.23+

# 撤销提交
git reset --soft HEAD~1     # 保留修改在暂存区
git reset --mixed HEAD~1    # 保留修改在工作区
git reset --hard HEAD~1     # 完全撤销修改

# 修改最后一次提交
git commit --amend -m "新的提交信息"

# 查看分支
git branch                  # 本地分支
git branch -r               # 远程分支
git branch -a               # 所有分支

# 创建分支
git branch feature-login
git checkout -b feature-login  # 创建并切换
git switch -c feature-login    # Git 2.23+

# 切换分支
git checkout main
git switch main             # Git 2.23+

# 删除分支
git branch -d feature-login    # 安全删除
git branch -D feature-login    # 强制删除

# 合并分支
git checkout main
git merge feature-login

# 变基合并
git checkout feature-login
git rebase main
git checkout main
git merge feature-login

# 压缩合并
git merge --squash feature-login
git commit -m "合并 feature-login 分支"

# 查看冲突文件
git status

# 手动解决冲突后
git add conflicted-file.txt
git commit -m "解决合并冲突"

# 使用合并工具
git mergetool

# 取消合并
git merge --abort

# 查看远程仓库
git remote -v

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 修改远程仓库 URL
git remote set-url origin git@github.com:user/repo.git

# 删除远程仓库
git remote remove origin

# 推送到远程仓库
git push origin main
git push -u origin main     # 设置上游分支

# 从远程仓库拉取
git pull origin main
git fetch origin            # 只获取不合并
git merge origin/main       # 手动合并

# 推送分支
git push origin feature-login
git push --set-upstream origin feature-login

main (生产分支)
├── develop (开发分支)
│   ├── feature/user-auth (功能分支)
│   ├── feature/payment (功能分支)
│   └── release/v1.2.0 (发布分支)
└── hotfix/critical-bug (热修复分支)

# 1. 从 main 创建功能分支
git checkout main
git pull origin main
git checkout -b feature/new-feature

# 2. 开发并提交
git add .
git commit -m "实现新功能"

# 3. 推送分支
git push origin feature/new-feature

# 4. 创建 Pull Request
# 在 GitHub 上创建 PR

# 5. 代码审查和合并
# 审查通过后合并到 main

# 6. 删除功能分支
git checkout main
git pull origin main
git branch -d feature/new-feature

# 格式：<type>(<scope>): <subject>
git commit -m "feat(auth): 添加用户登录功能"
git commit -m "fix(payment): 修复支付金额计算错误"
git commit -m "docs(readme): 更新安装说明"
git commit -m "style(header): 调整导航栏样式"
git commit -m "refactor(utils): 重构工具函数"
git commit -m "test(auth): 添加登录功能测试"

# 功能分支
feature/user-authentication
feature/payment-integration

# 修复分支
bugfix/login-error
hotfix/security-patch

# 发布分支
release/v1.2.0
release/2024-q1

# 交互式变基最近 3 个提交
git rebase -i HEAD~3

# 在编辑器中可以：
# pick：保留提交
# reword：修改提交信息
# edit：修改提交内容
# squash：合并到前一个提交
# drop：删除提交

# 储藏当前修改
git stash
git stash save "临时修改"

# 查看储藏列表
git stash list

# 应用储藏
git stash apply
git stash apply stash@{1}

# 弹出储藏
git stash pop

# 删除储藏
git stash drop stash@{1}
git stash clear  # 清空所有储藏

# 创建标签
git tag v1.0.0
git tag -a v1.0.0 -m "版本 1.0.0"

# 查看标签
git tag
git show v1.0.0

# 推送标签
git push origin v1.0.0
git push origin --tags

# 删除标签
git tag -d v1.0.0
git push origin --delete v1.0.0

# 方法1：创建反向提交
git revert HEAD

# 方法2：强制推送（危险）
git reset --hard HEAD~1
git push --force-with-lease origin main

# 查找分支的最后提交
git reflog

# 恢复分支
git checkout -b recovered-branch <commit-hash>

# 清理未跟踪文件
git clean -f
git clean -fd  # 包括目录

# 垃圾回收
git gc
git gc --aggressive