Published on

Git-How to manage your code workflow better

Authors
  • avatar
    Name
    Jason Lam / 林家祥
    Twitter

Git 的基本操作

Git 的基础使用还是相对比较简单的,很多网站都有基本入门教程,这里仅进行简单记录或记录我自己实际用到的一些命令

  • init:初始化仓库,用于没有「.git」文件夹的情况,初始化后会在当前目录下生成「.git」文件夹
  • clone:克隆远程仓库。需要注意的是基于 ssh 协议的 link 在后续进行操作时可能会有权限问题,建议使用 https 或者 gh 来进行操作
  • add:将变更保存到暂存区
  • status:查看当前状态
  • commit:将暂存区的变更进行确认提交。「-m」携带行内提交信息;「--amend」覆盖/修改上一次的提交
  • push:将本地分支推送到远程数据库,需要设置上游分支。「-f」强制推送,极度危险的操作
  • pull:拉取远程分支并合并到本地。「-r」进行 「rebase」变基到上游分支
  • fetch:获取远程数据库中本地没有的变动
  • rebase:变基,需要指定目标分支,将当前分支已提交的变更的分出点变更到目标
  • checkout/switch:检出/切换,都可以切换分支或者切到某个提交上,我更喜欢使用 switch。具体的不同后续再写
  • reset:重置,用于撤销/重做某些变更,有不同参数,是一个比较常用且不正确使用具有风险的操作,需要补充详细内容
  • tag:打标签。我自己实际使用比较少,所以基本没有什么了解

Git 技巧

Git 命令缩写与别名

如果你用的是「oh-my-zsh」,那么正常情况下应该默认有 「git」插件,如果没有的话就自己装一下 😆。这个插件附带了很多命令以及常用参数的别名,以及一些复杂操作的脚本(比如重命名分支):命令列表。当然还有其他的与 Git 有关的插件,请自行打开 Oh-My-Zsh 的插件列表进行查看

VSCode Git 插件

VSCode 上有很有 Git 的插件,在这里我建议通过这个 Git & GitHub Extension Pack 安装,它包含了以下插件:

Git Flow/工作流

对于代码,我们通常是以工程/项目作为单位进行组织,对于 Git 来说,则是仓库/Repo。对于个人开发者,尤其是刚刚入门或者刚使用 Git 的人来说,协作需求不多,更多的是个人的代码历史和版本的管理控制,在这个阶段,我们经常只在一个分支,通常是 master/main 上进行开发。笔者也是从这个阶段过来的,这样开发当然并没有非常大的问题,但是一旦项目进入到需要协同的阶段,亦或者在 CI/CD 上有新的要求,可能需要对整个 Git 工作流和仓库进行重新组织和管理。网上也有不同的流程规范,一旦你尝试用合理规范去约束个人行为以便代码管理更加高效,你就会爱上这种感觉。经过我个人的实践,我得出了一套既适用于个人也适用于小团队的工作流程。

根据业务和开发流程以及代码健壮性,有以下几种分支:

  • master/main:健壮的主分支。应该确保主分支都是可以基本运行且没有重大 Bug(即通过自测/测试)的,而且原则上不允许任何人直接对主分支进行直接修改,只能通过 PR/MR(Pull Request/Merge Request)来进行更新
  • [pre-]release/test/...:流程分支。根据具体的业务流程要求,需要切出不同的流程分支,用来进行发布前的测试,功能集成和预发布等
  • develop:开发分支。开发分支可以以不同含义进行组织管理,譬如开发者、特性/功能、紧急修复等,对应的前缀应该是 username、feature/function、hotfix,具体根据情况灵活变动

以上三种分支的健壮性通常来说是依次递减的,而且流程分支和开发分支可以以不同含义存在多个,以下流程为例子:

image-20221028155259255

参考文献: