自学内容网 自学内容网

Go 命名规范、git提交规范

参考自大佬:https://github.com/Andrew-M-C/code-style-guide/blob/master/file_system/file_system.md
本文为自己的学习记录

文件 / 目录命名规范

Go

  1. 如果已有现成风格, 则使用现成风格
  2. 文件使用全小写 snake 命名风格,比如: xxx_server.go
  3. 仓库的根目录采用小写 + 减号,比如: xxx-server
  4. 普通目录, 如果是 main 包,则采用小写 + 减号,比如: xxx-generator
  5. 普通目录, 如果是 Go package,则采用全小写,比如: xxxgenerator
  6. 普通目录, 如果没有任何属性,尽可能采用单个英文单词,如果实在不便需要采用多单词者,则采用全小写,比如 tencentcloud

Git Comment 书写规范

基本格式示例

[+] feat: <log/stack> 添加 XXXX 功能
上述示例有几个段落, 每个段落之间都有空格分割, 下面说明各段落作用:

示例 作用 详细说明
[+] 增删改符号 [+] 添加;[-] 删除;[*] 更新
feat: 变动类别
<log/stack> 子模块 如果是根目录则不需要这个字段
剩余 log 正文
变动类别说明:

  1. feat 功能性变更, 可以是产品需求也可以是研发需求。包括新增、修改、删除
  2. perf 优化相关,比如提升性能 (performance)
  3. fix 表示修复 bug 或调整不合理的逻辑
  4. docs 新增或修改文档和注释
  5. test 测试用例,包括单元测试、集成测试等
  6. revert 回滚代码
  7. refactor 代码重构,没有加新功能或者修复 bug
  8. style 仅仅修改了空格、格式缩进、逗号等等,不改变代码逻辑
  9. chore 上述分类未能覆盖的杂项变更

原文地址:https://blog.csdn.net/YiGeiGiaoGiao/article/details/143728176

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!