【译】Go语言编程模式

声明:本文为InfoQ中文站特供稿件,首发地址为:Go语言编程模式


在2016年伦敦举办的QCon大会上,Peter Bourgon做了《六年Go语言设计经验》的报告,重点探讨了在使用Go进行开发时的编程模式和反模式。在这里,我们将他给Go开发者的建议进行了简单的总结。

GOPATH:GOPATH/bin添加到“PATH”这个环境变量中,以便Go应用可以访问所需要的二进制文件。在绝大多数场景下,Bourgon建议使用全局唯一的GOPATH。有些开发者希望严格区分自己的代码和外部依赖代码,这些人更倾向于创建两个GOPATH条目。开发者也可以选择不设置环境变量,并针对每个工程都使用gb构建。

代码仓库的结构: 代码仓库的结构依赖于项目结构。如果是私人项目,开发者可以选择自己喜欢的任何结构。如果是开源项目,开发者最好遵循Remote Packages的建议,以便go get命令引用该项目的包。Bourgon建议创建一个基础目录,其中要包含程序的主要构件,以及放置帮助包的子目录,具体如下图所示:

代码格式化: Bourgon强调开发者需要重视Go的权威的代码格式化风格,一旦开发者习惯这种风格,他的代码的可读性将大大提高。按照Bougron的观点,Go开发者社区会认为非格式化的代码出自计算机新手。每次保存之前,可以使用gofmt工具格式化代码。他认为Go代码审核指南为开发者和代码审核者提供了一套通用的实践规则。他还支持Andrew Gerrand关于Go开发的建议,包括如何为变量、函数和exports等元素命名,如果你能够遵循这些建议,阅读你代码的人将会非常感激你。

配置: Bourgon建议配置管理应该有“清晰的定义和良好的文档支持。”他仍旧在使用来自标准库的flag包,不过也希望这个包能够更简单易懂。他强调了明确定义配置项的重要性。通过环境变量传递配置项并没有为应用的使用者提供足够的信息去理解应用的参数使用,他建议在help中提供必要的配置信息。

包名: 应该根据某个模块提供的服务而不是它的内容来定义包名。如果一个包含有HelloWorld消息,那么它不应该被称为commonconsts,而是greetings。包名应该表明它所做什么,而不是它有什么。

点导入: Bourgon建议不要使用“点导入”,这个特性通过设置点号来代替包名,使得开发者不需要明确的包名就可以访问相应包中的变量。这个特性降低了项目的可读性,尤其对于新手,新来的开发人员容易弄错哪个变量属于哪个包。Go——显式声明优于隐式声明。

Flags: Bourgon并不认为在init()方法而不在main()方法中初始化flags是一个好主意,因为这使得这些flags无法在全局领域使用,而某些测试用例要用到这些flags。

构造函数: 在谈到构造函数时,他建议将初始化的struct以内联方式直接作为参数传入,从而避免传入无效或者未完成的状态,例如:

foo := newFoo(*fooKey, fooConfig{
    Bar:    bar,
    Baz:    baz,
    Period: 100 * time.Millisecond,
})

有意义的默认值: 不要使用nil初始化某个变量,这使得每次在使用该变量的时候都需要进行空值检查,最好使用一个无操作值(no-operation value)进行变量初始化。例如,使用ioutil.Discard初始化一个output变量。

模块的交叉引用: 有些情况下会出现两个互相引用的模块。在构建其中的一个时,同时需要构建另一个模块,在构建后一个时又需要第一个先构建,下列两个structs的定义就属于这种情况:

type bar struct {
    baz *baz
}
type baz struct {
    bar *bar
}

Bourgon提供了三种方法处理这种情况:

  • 整合:两个关系如此密切的对象应该整合成一个,在这种情况下应该整合成一个barbaz结构体。
  • 分割:如果这两个模块必须保持分割,那么可以应用下列代码中采取的策略:
type bar struct {
    a *atom
    monad
}

type baz struct {
    atom
    m *monad
}

a := &atom{...}
m := newMonad(...)

bar := newBar(a, m, ...)
baz := newBaz(a, m, ...)
  • 通信:当上述两种方法都不适用时,可以考虑在两个模块之间发送消息。
type bar struct {
    toBaz chan<- event
}

type baz struct {
    fromBar <-chan event
}

c := make(chan event)

bar := newBar(c, ...)
baz := newBaz(c, ...)

依赖: Bourgon还提出了”明确依赖关系“的建议,例如:

unc (f *foo) process() {
    log.Printf("bar: %v", result) // ...
}

应该写成下面这样:

func (f *foo) process() {
    f.Logger.Printf("bar: %v", result) // ... 
}

log.Printf实际上调用了Logger模块,这么写的话就隐去了这层依赖关系。为了明确这层依赖关系,开发者应该在构造过程中创建一个Logger对象,并使用ioutil.Discard代替空值nil

通道(Channel): Bourgon建议,当多个协程(goroutine)之间共享内存时应使用mutex,并通过通道对协程进行协调。

日志打印: 日志记录的代价很高,有可能成为应用的性能瓶颈。因此,建议只在绝对必要的地方记录日志,包括给开发者阅读或者供机器调用的信息。仅仅需要记录infodebug级别的日志。

监控工具: Bourgon认为Go应用的监控代价很小,推荐开发者使用Prometheus监控自己应用使用的各种资源。

全局状态: 消除隐式的全局依赖和全局状态。

测试: 执行包级别的测试。为了测试而设计:使用函数式编程风格——使用参数表明依赖关系、使用接口以及避免依赖全局状态。

依赖管理: 将所有依赖项都拷贝到项目的仓库中用于构建二进制代码。Bourgon建议开发者根据自己的需要从gvtvendettaglidegb这几个工具中选择。

构建: 不要使用go build,要使用go install,因为后者可以缓存依赖关系,并把这些依赖关系放在GOPATH/bin下以便于调用。

这些建议已经被应用于开发Go Kit,一款用于构建微服务的分布式编程工具。

2009年以来,Bourgon在SoundCloud和Weaveworks两家公司都使用Go语言开发,开发了几款产品,包括:Roshi——一款基于时间序列的事件数据库,以及Go Kit。

2016年QCon大会上的《六年Go语言设计经验》视频将会在今年晚些时候对外公开。

查看英文原文:Programming Patterns in Go


本号专注于后端技术、JVM问题排查和优化、Java面试题、个人成长和自我管理等主题,为读者提供一线开发者的工作和成长经验,期待你能在这里有所收获。


javaadu
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,717评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,501评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,311评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,417评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,500评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,538评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,557评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,310评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,759评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,065评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,233评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,909评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,548评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,172评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,420评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,103评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,098评论 2 352

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,980评论 25 707
  • 引言 Go 语言这两年在语言排行榜上的上升势头非常猛,Go 语言虽然是静态编译型语言,但是它却拥有脚本化的语法,支...
    一缕殇流化隐半边冰霜阅读 33,478评论 11 90
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,646评论 18 139
  • Go入门 Go介绍 部落图鉴之Go:爹好还这么努力? 环境配置 安装 下载源码编译安装 下载相应平台的安装包安装 ...
    齐天大圣李圣杰阅读 4,582评论 0 26
  • 溪溪的骨子里流淌着回民好做生意的基因。 溪溪的曾祖、曾外祖以及祖母、父辈都热衷做生意,都是靠生意起的家,一直到现在...
    排云鹤_d036阅读 328评论 0 1