前端编码规范之:Git使用规范

  1. 前端编码规范之:Git使用规范
  2. 前端编码规范之:样式(scss)编码规范
  3. 前端编码规范之:HTML结构规范
  4. 前端编码规范之:Vue最佳实践
  5. 前端编码规范之:Javascript编码规范

整理了下,基本的git操作可以自己新建一个github的repo熟悉下。

Git版本规范

分支

  • master分支为主分支(保护分支),不能直接在master上进行修改代码和提交
  • develop分支为测试分支,所以开发完成需要提交测试的功能合并到该分支
  • feature分支为开发分支,大家根据不同需求创建独立的功能分支,开发完成后合并到develop分支,merge完成就可以删除
  • fix分支为bug修复分支,需要根据实际情况对已发布的版本进行漏洞修复,merge完成就可以删除

Tag

采用三段式,v版本.里程碑.序号,如v1.2.1

  • 架构升级或架构重大调整,修改第2位
  • 新功能上线或者模块大的调整,修改第2位
  • bug修复上线,修改第3位

changelog

版本正式发布后,需要生产changelog文档,便于后续问题追溯

commit message规范

Commit message一般包括三部分:Header、Body和Footer

Header

type(scope):subject。

  • type:用于说明commit的类别,规定为如下几种

    • feat:新增功能;
    • fix:修复bug;
    • docs:修改文档;
    • refactor:代码重构,未新增任何功能和修复任何bug;
    • build:改变构建流程,新增依赖库、工具等(例如webpack修改);
    • style:仅仅修改了空格、缩进等,不改变代码逻辑;
    • perf:改善性能和体现的修改;
    • chore:非src和test的修改;
    • test:测试用例的修改;
    • ci:自动化流程配置修改;
    • revert:回滚到上一个版本;
  • scope:【可选】用于说明commit的影响范围
  • subject:commit的简要说明,尽量简短

Body

  • 对本次commit的详细描述,可分多行

尾部(Footer)

  • 不兼容变动:需要描述相关信息
  • 关闭指定Issue:输入Issue信息

Git Commit 优点

  • 统一团队Git Commit标准,便于后续代码review、版本发布、自动化生成change log
  • 可以提供更多更有效的历史信息,方便快速预览以及配合cherry-pick快速合并代码
  • 团队其他成员进行git blame等操作可以快速明白代码用意

原文:Git Commit 规范以及emoji 使用指南

git commit emoji 使用指南

============================
来源:git commit emoji 使用指南

目录

  • commit 格式
  • emoji 指南
  • 如何在命令行中显示 emoji
  • 参考

    • git commit emoji
    • write a good commit message

执行 git commit 时使用 emoji 为本次提交打上一个 "标签", 使得此次 commit 的主要工作得以凸现,也能够使得其在整个提交历史中易于区分与查找。

截取的 gitmoji 快照:

https://github.com/liuchengxu...
前端编码规范之:Git使用规范_第1张图片

commit 格式

git commit 时,提交信息遵循以下格式:

:emoji1: :emoji2: 不超过 50 个字的摘要,首字母大写,使用祈使语气,句末不要加句号

提交信息主体

引用相关 issue 或 PR 编号 <#110>

初次提交示例:

git commit -m ":tada: Initialize Repo"

emoji 指南

emoji emoji 代码 commit 说明
(庆祝) :tada: 初次提交
(火花) :sparkles: 引入新功能
(书签) :bookmark: 发行/版本标签
(bug) :bug: 修复 bug
(急救车) :ambulance: 重要补丁
(地球) :globe_with_meridians: 国际化与本地化
(口红) :lipstick: 更新 UI 和样式文件
(警车灯) :rotating_light: 移除 linter 警告
(扳手) :wrench: 修改配置文件
(加号) :heavy_plus_sign: 增加一个依赖
(减号) :heavy_minus_sign: 减少一个依赖
(上升箭头) :arrow_up: 升级依赖
(下降箭头) :arrow_down: 降级依赖
(闪电)
(赛马)
:zap:
:racehorse:
提升性能
(上升趋势图) :chart_with_upwards_trend: 添加分析或跟踪代码
(火箭) :rocket: 部署功能
(白色复选框) :white_check_mark: 增加测试
(备忘录) :memo: 撰写文档
(锤子) :hammer: 重大重构
(调色板) :art: 改进代码结构/代码格式
(火焰) :fire: 移除代码或文件
(铅笔) :pencil2: 修复 typo
(施工) :construction: 工作进行中
(工人) :construction_worker: 添加 CI 构建系统
(绿心) :green_heart: 修复 CI 构建问题
(锁) :lock: 修复安全问题
(鲸鱼) :whale: Docker 相关工作
(苹果) :apple: 修复 macOS 下的问题
(企鹅) :penguin: 修复 Linux 下的问题
(旗帜) :checked_flag: 修复 Windows 下的问题

如何在命令行中显示 emoji

默认情况下,在命令行中并不会显示出 emoji, 仅显示 emoji 代码。不过可以使用 emojify 使得在命令行也可显示 emoji, 它是一个 shell 脚本,安装与使用都很简单,在 这里 查看如何安装与使用。

https://github.com/liuchengxu...
前端编码规范之:Git使用规范_第2张图片

参考

git commit emoji

  • gitmoji
  • emoji-cheat-sheet
  • styleguide-git-commit-message
  • atom git commit messages guide
  • An emoji guide for your commit messages
  • 程序员提交代码的 emoji 指南——原来表情文字不能乱用

write a good commit message

  • A Note About Git Commit Messages
  • How to write a Git Commit Message (2014)
  • how to write a good git commit message
  • 5 Useful Tips For A Better Commit Message
  • Udacity Git Commit Message Style Guide
  • How to commit a change with both “message” and “description” from the command line?

你可能感兴趣的:(前端编码规范之:Git使用规范)