20 KiB

Brut Annotations Historique

代码管理相关知识点

Git

Git的概念

Git是一个开源的分布式版本控制系统，它能够高效地处理从小到大的项目。

三个区域的概念

工作区

平时存放项目的地方，可以在工作区直接修改。
暂存区

用于临时存放改动，保存即将提交的文件列表信息。
仓库区（版本库）

就是安全存放数据的位置，这里面有提交到所有版本的数据（版本快照）。
仓库的概念
- Git仓库是存储文件和历史记录的地方。
节点的概念

是Git中的基本概念，它代表着代码库的一个特定状态。每当你在Git中提交代码时，都会创建一个新的节点来保存当前代码库的状态。每个节点都有一个唯一的标识符，即SHA-1哈希值，用来标识该节点的内容和父节点。
分支的概念

是基于节点的一个引用，它指向一个节点作为该分支的起点。通过创建分支，可以在代码库中开发新的功能、修复bug或实施其他更改，而不会影响原始分支。每个分支都有一个名称，通常用来描述该分支的目的或特点。分支之间可以相互合并，通过合并可以将不同分支上的更改合并到一起。
文件的状态
- 已修改：文件内容已经被修改。
- 已删除：文件本身已经被删除（工作区删除，存储区还有）。
- 变更：文件本身没有修改，但是改变了存放位置。
- 未管理：尚未添加到版本管理的文件，比如新添加的文件。
- 忽略：不需要添加到版本管理的文件。
- 冲突：合并的时候同时修改了同一块的内容，所有需要人为取解决冲突。

SourceTree

SourceTree的概念

SourceTree 是 Windows 和Mac OS X 下免费的 **Git 客户端，**拥有可视化界面，容易上手操作。

仓库相关操作

创建本地仓库（修改）

有文件夹创建新文件

在浏览里面选择我们要创建本地仓库的文件夹。

点击是

创建成功

浏览里面选择要创建仓库的文件夹，即可以在该文件夹建立一个仓库，生成.git文件。

没有文件夹创建本地仓库
- 选择路径
- 桌面出现文件夹
- 仓库建立成功

打开本地仓库

注意：在打开目标仓库的路径时候，不能点进隐藏文件.git文件

克隆远程仓库（修改）

获取URL：http://gitea.xinje.cc/wangshunkui/kong.git

克隆

填写URL地址和Clone到的空文件夹

远端的内容

点击克隆

实现结果

获取

获取是从远程仓库获取信息并同步至本地仓库（获取只会同步到本地仓库，不会更改工作文件）

关联远程仓库

注意：步骤四自己对远端电脑随便取个名就行。

在 SourceTree 中，克隆远程仓库是指从远程 Git 仓库中下载完整的项目代码和提交历史，创建一个新的本地项目副本；而关联远程仓库是指在本地已存在的 Git 仓库中，添加一个远程仓库地址，以便将本地代码推送到远程或从远程拉取更新。两者的主要区别在于：克隆用于从远程获取项目，自动建立关联并初始化本地项目；而关联远程用于让已有的本地项目与远程仓库建立联系，通常用于首次推送代码。

节点相关操作

提交

将工作区的内容放到仓库的这个过程叫做提交。将写完后的文档先添加到暂存区，然后再写日志提交。每一次提交产生一个节点。

回滚提交（修改）

“回滚提交”指的是对 Git 历史中的某个提交进行撤销、修改或恢复的操作。常见的回滚行为包括：

撤销最近的提交
恢复到某个旧的提交版本
撤销某一次错误的提交（保留历史）
- 回滚前

回滚后

回滚的回滚
回滚到第一次回滚的回滚
回滚多部操作

产生冲突，需要去解决冲突

重置当前分支到此次提交

Source Tree三种合并和区别（修改）

混合合并：

混合合并以后文件文件保存到了未暂存区，提供一次修改机会。

强行合并:

是指将此次提交回滚到指定的位置，但这个过程中将直接丢弃之前修改的所有文件。

软合并：

软合并之后，文件保存到暂存区，给一次修改机会。

分支相关操作

新建分支

创建的分支和主分支是完全一样的东西，新建分支旁边有圈代表分支激活，东西保存在该分支当中。

合并分支（修改）

激活master，选择要合并的支线，点击确定，将支线的所有变化的节点打包创建一个新节点合并过去。

切换到目标分支（如 master）
点击上方菜单栏的：分支 → 合并（Merge）
在弹窗中选择你要合并进来的源分支（如 dev1）
点击“确定”开始合并
如果有冲突，会提示你处理冲突
处理完冲突后，提交合并记录

分支合并到主分支

分支1合并到分支2

解决冲突

合并成功

分支的分支合并到主分支

合并成功

删除分支（修改）

切换出要删除的分支，你不能删除当前正在使用的分支。请先切换到其他分支。
在左侧分支列表中，右键你要删除的分支
选择 “删除分支” 或
会弹出确认窗口，点击 “删除” 确认即可

注意尚未合并的分支不能删除（即没有备份的分支）

强行删除没有合并的分支

因为分支没有和主分支合并，所以删除失败

适用场景和意义

场景	意义
🔁 分支内容无用	某个分支用于试验、测试，最终未采用，强行删除避免冗余。
🧹 清理历史	清理长期未合并、开发中断的“僵尸分支”。
🚫 修复误操作	某分支是误建的，未提交或提交错误，无法 merge，不如直接强制删除。
🔒 防止危险代码流入主干	某分支包含危险改动或潜在 Bug，为避免 merge 到主分支，立即删除。
⚠️ 冲突太多，放弃合并	分支与主干差异大、冲突重，重建更清晰，强行删除原分支。

切换分支（修改）

双击要切换的分支名字,出现小圆圈为激活状态。

检出分支

“检出（checkout）远程分支” 是指你将某个远程仓库（如 origin）上的分支拿到本地来使用、开发或查看的操作。

制造冲突（修改）

本地冲突：

分支2修改：

分支1修改：

合并分支：

产生冲突：

如果分支一修改了1.txt，分支2修改了1.txt且修改位置意义，修改内容不同合并时候就会产生冲突。

远程冲突：

本地3.txt的内容：

远端3.txt的内容：

修改本地3.txt的内容：

提交推送：

报错：

解决冲突

本地冲突:

方式一：在需要提交的文件里面自己手动保留要更改的内容，然后鼠标右键选择已经解决冲突。

方式二：方式是以我为准激活的分支的内容是我要保留的内容。

方式三：以别人为准就是合并时候保存要合并的那个分支的内容。

远程冲突：

拉取：

解决冲突再重新推送：

拉取

选择从远端仓库中哪个分支获取。

推送

选择要发送到远端仓库的分支，点击推送。

其他

书写忽略文件

方式一：选择修改的文件，右击选择忽略。

方式二：

忽略指定文件：在 .gitignore 中添加精确文件名，如 lalala.txt，表示忽略该文件的所有更改。
忽略特定类型的文件：使用通配符后缀，如 *.md 表示忽略所有 .md 结尾的文件。
忽略特定文件夹：使用路径方式，如 /name 表示忽略项目根目录下的 name 文件夹及其所有内容。

停止跟踪

停止跟踪的作用是让 Git 不再对某个已经被版本控制的文件或文件夹进行管理，这意味着即使你之后对该文件进行了修改、重命名或删除，Git 也不会再将这些更改记录到提交中。

本地文件停止跟踪：

方式一：选择要停止跟踪的文件，然后右击鼠标，选择停止跟踪。

方式二：没有更改需要停止跟踪的文件，选择停止跟踪。

第一步，选择要停止跟踪的文件
点击操作
点击停止跟踪

停止跟踪远程分支：

创建补丁（修改）

在 SourceTree 中，**选择你要导出补丁的提交
右键点击 → 选择 “创建补丁” 或 “Export patch”
选择保存路径，SourceTree 会导出为 .patch 文件
将该补丁文件发送给他人或用于其他仓库应用

在分支创建补丁的意义

目的	原因和优势
1. 避免污染主分支	主分支（如 `master`、`main`）通常要保持稳定、可发布。在新建分支上做补丁开发，不会影响主线。
2. 更容易管理改动	分支相当于“一个封闭的变更沙箱”，方便组织、测试和提交改动。
3. 方便团队协作	提交到分支后，其他开发者可以基于该分支拉取代码、做代码审查（Review）或测试。
4. 创建补丁文件	使用 `git format-patch` 可以导出成 `.patch` 文件供邮件发送、打包发布或代码审计。