文章目录
- 1. git功能
- 2. git体验
- 3. github是什么
- 4. GitHub与Git关系
- 5. github创建项目
- 6. 如何用好 GitHub
- 7 git提交规范
- 7.1 工作写法
- 7.2 常规写法
- 7.3 开源应用、开源库写法
1. git功能
从一般开发者的角度来看,git有以下功能:
- 从服务器上克隆数据库(包括代码和版本信息)到单机上。
- 在自己的机器上创建分支,修改代码。
- 在单机上自己创建的分支上提交代码。
- 在单机上合并分支。
- 新建一个分支,把服务器上最新版的代码fetch下来,然后跟自己的主分支合并。
- 生成补丁(patch),把补丁发送给主开发者。
- 看主开发者的反馈,如果主开发者发现两个一般开发者之间有冲突(他们之间可以合作解决的冲
突),就会要求他们先解决冲突,然后再由其中一个人提交。如果主开发者可以自己解决,或者
没有冲突,就通过。 - 一般开发者之间解决冲突的方法,开发者之间可以使用pull 命令解决冲突,解决完冲突之后再
向主开发者提交补丁。
从主开发者的角度(假设主开发者不用开发代码)看,git有以下功能: - 查看邮件或者通过其它方式查看一般开发者的提交状态。
- 打上补丁,解决冲突(可以自己解决,也可以要求开发者之间解决以后再重新提交,如果是开源
项目,还要决定哪些补丁有用,哪些不用)。 - 向公共服务器提交结果,然后通知所有开发人员。
2. git体验
如果是第一次使用Git,你需要设置署名和邮箱:
$ git config --global user.name "用户名"
$ git config --global user.email "电子邮箱"
将代码仓库clone到本地,其实就是将代码复制到你的机器里,并交由Git来管理:
$ git clone git@github.com:someone/symfony-docs-chs.git
你可以修改复制到本地的代码了(symfony-docs-chs项目里都是rst格式的文档)。当你觉得完成
了一定的工作量,想做个阶段性的提交:
向这个本地的代码仓库添加当前目录的所有改动:
$ git add .
或者只是添加某个文件:
$ git add -p
我们可以输入
$git status
# 位于分支 main
# 要提交的变更:
# (使用 "git reset HEAD..." 撤出暂存区)
#
# 新文件: descriptor.sh
#
可以看到状态的变化是从黄色到绿色,即unstage
到add
。
3. github是什么
GitHub 是一个共享虚拟主机服务,用于存放使用Git版本控制的软件代码和内容项目。它由GitHub公司(曾称Logical
Awesome)的开发者Chris Wanstrath、PJ Hyett和Tom Preston-Werner使用Ruby on Rails编写而成。
它还是什么?
- 网站
- 免费博客
- 管理配置文件
- 收集资料
- 简历
- 管理代码片段
- 托管编程环境
- 写作
- 版本管理与软件部署
4. GitHub与Git关系
Git
是一个分布式的版本控制系统,最初由Linus Torvalds
编写,用作Linux内核代码的管理。在推出后,Git在其它项目中也取
得了很大成功,尤其是在Ruby社区中。目前,包括Rubinius
、Merb
和Bitcoin
在内的很多知名项目都使用了Git。Git同样可以被
诸如Capistrano
和Vlad the Deployer
这样的部署工具所使用。
GitHub
可以托管各种git库,并提供一个web界面,但与其它像 SourceForge或Google Code这样的服务不同,GitHub的独特卖
点在于从另外一个项目进行分支的简易性。为一个项目贡献代码非常简单:首先点击项目站点的“fork”的按钮,然后将代码检出并将
修改加入到刚才分出的代码库中,最后通过内建的“pull request”机制向项目负责人申请代码合并。已经有人将GitHub称为代码
玩家的MySpace。
5. github创建项目
- git本地项目上传github或gitlab入门
6. 如何用好 GitHub
如何用好 GitHub,并实践一些敏捷软件开发是一个很有意思的事情.我们可以在上面做很多事情,从测试到CI,再到自动部署., 敏捷软件开发
瀑布流是怎样的?
一个项目的组成:
- 代码
- CI
- 测试
- 自动化测试
- 文档
- 版本管理
- 自动部署
代码模块化
自动化测试
代码质量与重构
7 git提交规范
7.1 工作写法
格式
[任务卡号] xx & xx: do something
比如: [PHODAL-0001] ladohp & phodal: update documents
,解释如下:
- PHODAL-0001 ,业务的任务卡号,它可以帮我们找到某个业务修改的原因,即点出相应 bug 的来源
- ladohp & phodal ,结对编程的两个人的名字,后者(phodal)一般是写代码的人,出于礼貌就放在后面了。由于 Git的提交人只显示一个,所以写上两个的名字。当提交的人不在时,就可以问另外一个人修改的原因。
- update documents ,我们做了什么事情
缺点:而对于采用看板的团队来说,并不存在任务卡号这种东西,因此就需要一种额外的作法。
7.2 常规写法
格式
[任务分类] 主要修改组件(可选):修改内容
示例 1, [T] tabs: add icons
。其中的 T
表示这是一个技术卡, tabs
表示修改的是Tabs, add icons
则表示添加了图标。
示例 2, [SkillTree] detail: add link data
。其中的 SkillTree
表示修改的是技能树 Tab 下的内容, detail
则表示修改的是详情页, add link data
则表示是添加了技能的数据
这样做的主要原因是,它可以轻松也帮我 filter 出相应业务的内容。
缺点:要这样做需要团队达到一致,因此付出一些额外的成本。
7.3 开源应用、开源库写法
与我们日常工作稍有不同的是:工作中的 Release 计划一般都是事先安排好的,不需要一些CHANGELOG 什么的。而开源应用、开源库需要有对应的 CHANELOG,则添加了什么功能、修改了什么等等。毕竟有很多东西是由社区来维护的。
诸如: docs(changelog): update change log to beta.5
中:
- docs 则对应修改的类型
- changelog 则是影响的范围
- subject 则是对应做的事件
对应的类型有:
- build: 影响构建系统或外部依赖关系的更改(示例范围:gulp,broccoli,npm)
- ci: 更改我们的持续集成文件和脚本(示例范围:Travis,Circle,BrowserStack,SauceLabs)
- docs: 仅文档更改
- feat: 一个新功能
- fix: 修复错误
- perf: 改进性能的代码更改
- refactor: 代码更改,既不修复错误也不添加功能
- style: 不影响代码含义的变化(空白,格式化,缺少分号等)
- test: 添加缺失测试或更正现有测试