前言

Git 是一个分布式版本控制系统，用于高效地管理代码版本历史和分支协作开发，主要概念有：

  • 工作区（Working Directory）：你当前正在编辑的文件
  • 暂存区（Staging Area）：你打算提交的文件
  • 本地仓库（Local Repository）：本地的历史提交记录
  • 远程仓库（Remote Repository）：如 GitHub、GitLab 上的共享仓库

开发者通常在本地频繁提交（commit），每次提交都会生成一个唯一的哈希值（SHA-1），确保代码历史不可篡改且可溯源。然后再推送（ push）到远程仓库，团队成员也可拉取（pull）最新代码，借助分支机制（branch）并行开发功能，再合并/变基（merge/rebase），保持主线整洁有序。

下面的示例操作，默认主分支main、工作分支dev、远程仓库origin。

项目发布

  1. 初始化（init）本地仓库，默认主分支为 master ，建立与远程（remote）仓库的连接

    git init
git branch -m master main							# 对齐远程主分支名称
git remote add origin <remoteAdress>
git remote set-url origin <remoteAdress>			# 修改远程仓库地址

  2. 或者直接复制（clone）远程仓库，默认主分支为 main

    git clone <remoteAdress>

  3. 检查仓库状态（status），对本地仓库内容进行暂存（add）并提交

    git status
...													# 项目开发
git add .
git commit -m "<changes>"

  4. 将本地仓库更改推送到远程仓库，第一次需要建立upstream，之后直接推送即可

    git push -u origin main

分支开发

  1. 检查远程和分支，获取（fetch）待开发主分支

    git remote 											# 检查远程仓库
git remote show origin		  	 					# 检查远程仓库对应地址
git remote -v										# 检查所有远程仓库及对应地址
git branch											# 检查本地仓库所有分支
git branch -a										# 检查所有分支
git fetch main										# 获取远程待开发主分支
git fetch --all										# 获取远程所有分支

  2. 切换（checkout）或创建工作分支，在工作分支上进行开发

    git checkout -b dev									# 创建并切换到工作分支
git checkout dev									# 切换到工作分支
...											   		# 项目开发
git add <files>
git commit -m "<changes>"

  3. 切换回主分支，拉取最新代码

    git checkout main									# 切换回主分支
git pull origin main								# 拉取主分支最新代码

  4. 切换到工作分支去合并主分支最新代码

    git checkout dev									# 再次切换到工作分支
git merge main										# 合并主分支到工作分支

  5. 切换回主分支去合并工作分支，并推送到远程服务器

    git checkout main									# 再次切换回主分支
git merge dev										# 合并工作分支到主分支
git push origin main 								# 推送到远程

  6. 删除多余的工作分支

    git checkout main
git branch -D dev									# 删除本地工作分支
git push origin --delete dev						# 删除远程工作分支

版本控制

提交历史（log）

  • git log <branchName>：查看分支提交历史，默认查看当前分支提交历史
  • git tag <hashName> <hash>：给版本哈希值取别名，默认给 HEAD 版本取别名
    • /：对应每一次提交
    • ：对应分支上最新提交
    • HEAD：当前分支最新提交
    • HEAD~n：当前分支第n+1新提交
  • git checkout <hash>：切换到版本

版本回退

  • git clean -n&git clean -fd：清理未跟踪文件

  • git restore <files>/git checkout .：撤回工作区的修改，但不会影响未跟踪文件

  • git restore --staged <files>：将暂存区内容撤回到工作区

  • git stash -u|git stash apply&git stash clear：临时寄存或弹出工作区和暂存区的改动

  • git diff <hash1> <hash2> > output.txt&git apply output.txt：重定向版本差异再应用

  • git commit --amend：修改最新提交Msg

  • git reset --<mode> <hash>：移动HEAD到版本而回退，此时该分支本地和远程提交记录不一致，需要强制推送（push -f）覆盖

    modeHEAD 回退暂存区（Stage）工作区（file）
    --soft✅✅保留✅保留
    --mixed✅❌清除✅保留
    --hard✅❌清除❌清除

    即使回退了，只要回退版本之后的提交没有被垃圾回收，则依然可以被git reflog查看或者git reset --hard <hash>找回

  • git revert <hash>：创建一个新提交抵消版本而撤销，保持历史完整性，但合并时可能产生冲突，需要解决后add再git revert --continue

  • git cherry-pick <hash>：应用某个特定提交到当前分支

  • git checkout --orphan fresh：刷新仓库历史

冲突处理

代码冲突

当进行合并、变基、拉取和弹栈操作时，若不同分支的提交中，同一文件里的同一处代码不一致，就会产生代码冲突 conflict。

git status
# both modified: <files>

此时进入冲突文件中，手动解决冲突，重新git add <files>，然后

git commit -m "<changes>"

或者

git merge --continue
git rebase --continue

无法解决的冲突，可以中断

git merge --abort
git rebase --abort

版本冲突

  • 本地分支与远程主线分支形成分叉提交；合并历史混乱

    # Your branch and 'origin/main' have diverged,
git pull --rebase			# 以变基方式拉取并合并代码
git push

  • 相比远程分支，本地分支提交回退或重写历史

    # ! [rejected] main -> main (non-fast-forward)
git push --force			# 覆盖远程历史

  • 相比远程分支，本地分支落后很多新提交，且自己提交了部分

    git fetch					# 同步远程分支
git merge origin/main
git rebase origin/main		# 或者

  • 不相关仓库分支合并

    # # Error：refusing to merge unrelated histories
git pull origin main --allow-unrelated-histories	# 允许合并下拉

冷知识

CRLF换行符

现象：跨平台工作空间commit项目时Warning:LF will be replaced by CRLF，再次clone后文件乱码

原因：换行主要与CR回车\r、LF换行\n相关，文件行尾的换行符在不同编辑器和不同平台下具有不同的表示：Linux和macOS使用LF换行，而Dos和Windows使用CR LF换行，在编辑器中体现为KEYEnter

  • 方法一：更改git config --global|system|local

    # 单独开发的程序员：提交检出均不转换
git config --global core.autocrlf false

# 多人协作跨平台开发的window程序员：提交时转换为LF，检出时转换为CRLF
git config --global core.autocrlf true

# 多人协作跨平台开发的Linux程序员：提交时转换为LF，检出时不转换
git config --global core.autocrlf input

  • 方法二：创建项目文件.gitattributes设置eol=crlf或者eol=lf