Go的50坑:新Golang开发者要注意的陷阱、技巧和常见错误
Go是一门简单有趣的语言,但与其他语言类似,它会有一些技巧。这些技巧的绝大部分并不是Go的缺陷造成的。如果你以前使用的是其他语言,那么这其中的有些错误就是很自然的陷阱。其它的是由错误的假设和缺少细节造成的。
如果你花时间学习这门语言,阅读官方说明、wiki、邮件列表讨论、大量的优秀博文和Rob Pike的展示,以及源代码,这些技巧中的绝大多数都是显而易见的。尽管不是每个人都是以这种方式开始学习的,但也没关系。如果你是Go语言新人,那么这里的信息将会节约你大量的调试代码的时间。
目录
初级篇
- 大括号不能放在单独的一行
- 未使用的变量
- 未使用的Imports
- 简式的变量声明仅可以在函数内部使用
- 使用简式声明重复声明变量
- 偶然的变量隐藏Accidental Variable Shadowing
- 不使用显式类型,无法使用“nil”来初始化变量
- 使用“nil” Slices and Maps
- Map的容量
- 字符串不会为“nil”
- Array函数的参数
- 在Slice和Array使用“range”语句时的出现的不希望得到的值
- Slices和Arrays是一维的
- 访问不存在的Map Keys
- Strings无法修改
- String和Byte Slice之间的转换
- String和索引操作
- 字符串不总是UTF8文本
- 字符串的长度
- 在多行的Slice、Array和Map语句中遗漏逗号
- log.Fatal和log.Panic不仅仅是Log
- 内建的数据结构操作不是同步的
- String在“range”语句中的迭代值
- 对Map使用“for range”语句迭代
- "switch"声明中的失效行为
- 自增和自减
- 按位NOT操作
- 操作优先级的差异
- 未导出的结构体不会被编码
- 有活动的Goroutines下的应用退出
- 向无缓存的Channel发送消息,只要目标接收者准备好就会立即返回
- 向已关闭的Channel发送会引起Panic
- 使用"nil" Channels
- 传值方法的接收者无法修改原有的值
进阶篇
- 关闭HTTP的响应
- 关闭HTTP的连接
- 比较Structs, Arrays, Slices, and Maps
- 从Panic中恢复
- 在Slice, Array, and Map "range"语句中更新引用元素的值
- 在Slice中"隐藏"数据
- Slice的数据“毁坏”
- "走味的"Slices
- 类型声明和方法
- 从"for switch"和"for select"代码块中跳出
- "for"声明中的迭代变量和闭包
- Defer函数调用参数的求值
- 被Defer的函数调用执行
- 失败的类型断言
- 阻塞的Goroutine和资源泄露
高级篇
- 使用指针接收方法的值的实例
- 更新Map的值
- “nil” Interfaces和"nil" Interfaces的值
- 栈和堆变量
- GOMAXPROCS, 并发, 和并行
- 读写操作的重排顺序
- 优先调度
初级篇
开大括号不能放在单独的一行
● level: beginner
在大多数其他使用大括号的语言中,你需要选择放置它们的位置。Go的方式不同。你可以为此感谢下自动分号的注入(没有预读)。是的,Go中也是有分号的:-)
失败的例子:
package main
import"fmt"
func main(){//error, can't have the opening brace on a separate line
fmt.Println("hello there!")}
编译错误:
/tmp/sandbox826898458/main.go:6: syntax error: unexpected semicolon or newline before {
有效的例子:
package main
import"fmt"
func main(){
fmt.Println("works!")}
未使用的变量
● level: beginner
如果你有未使用的变量,代码将编译失败。当然也有例外。在函数内一定要使用声明的变量,但未使用的全局变量是没问题的。
如果你给未使用的变量分配了一个新的值,代码还是会编译失败。你需要在某个地方使用这个变量,才能让编译器愉快的编译。
Fails:
package main
var gvar int//not an error
func main(){var one int//error, unused variable
two :=2//error, unused variablevar three int//error, even though it's assigned 3 on the next line
three =3}
Compile Errors:
/tmp/sandbox473116179/main.go:6: one declared andnot used /tmp/sandbox473116179/main.go:7: two declared andnot used /tmp/sandbox473116179/main.go:8: three declared andnot used
Works:
package main
import"fmt"
func main(){var one int
_ = one
two :=2
fmt.Println(two)var three int
three =3
one = three
var four int
four = four
}
另一个选择是注释掉或者移除未使用的变量
未使用的Imports
● level: beginner
如果你引入一个包,而没有使用其中的任何函数、接口、结构体或者变量的话,代码将会编译失败。
如果你真的需要引入的包,你可以添加一个下划线标记符, _,来作为这个包的名字,从而避免编译失败。下滑线标记符用于引入,但不使用。
Fails:
package main
import("fmt""log""time")
func main(){}
Compile Errors:
/tmp/sandbox627475386/main.go:4: imported andnot used:"fmt"/tmp/sandbox627475386/main.go:5: imported andnot used:"log"/tmp/sandbox627475386/main.go:6: imported andnot used:"time"
Works:
package main
import(
_ "fmt""log""time")var _ = log.Println
func main(){
_ = time.Now}
另一个选择是移除或者注释掉未使用的imports :-)
简式的变量声明仅可以在函数内部使用
● level: beginner
Fails:
package main
myvar :=1//error
func main(){}
Compile Error:
/tmp/sandbox265716165/main.go:3: non-declaration statement outside function body
Works:
package main
var myvar =1
func main(){}
使用简式声明重复声明变量
● level: beginner
你不能在一个单独的声明中重复声明一个变量,但在多变量声明中这是允许的,其中至少要有一个新的声明变量。
重复变量需要在相同的代码块内,否则你将得到一个隐藏变量。
Fails:
package main
func main(){
one :=0
one :=1//error}
Compile Error:
/tmp/sandbox706333626/main.go:5:nonew variables on left side of :=
Works:
package main
func main(){
one :=0
one, two :=1,2
one,two = two,one
}
偶然的变量隐藏Accidental Variable Shadowing
● level: beginner
短式变量声明的语法如此的方便(尤其对于那些使用过动态语言的开发者而言),很容易让人把它当成一个正常的分配操作。如果你在一个新的代码块中犯了这个错误,将不会出现编译错误,但你的应用将不会做你所期望的事情。
package main
import"fmt"
func main(){
x :=1
fmt.Println(x)//prints 1{
fmt.Println(x)//prints 1
x :=2
fmt.Println(x)//prints 2}
fmt.Println(x)//prints 1 (bad if you need 2)}
即使对于经验丰富的Go开发者而言,这也是一个非常常见的陷阱。这个坑很容易挖,但又很难发现。
不使用显式类型,无法使用“nil”来初始化变量
● level: beginner
“nil”标志符用于表示interface、函数、maps、slices和channels的“零值”。如果你不指定变量的类型,编译器将无法编译你的代码,因为它猜不出具体的类型。
Fails:
package main
func main(){var x =nil//error
_ = x
}
Compile Error:
/tmp/sandbox188239583/main.go:4:use of untyped nil
Works:
package main
func main(){var x interface{}=nil
_ = x
}
使用“nil” Slices and Maps
● level: beginner
在一个“nil”的slice中添加元素是没问题的,但对一个map做同样的事将会生成一个运行时的panic。
Fails:
package main
func main(){var m map[string]int
m["one"]=1//error}
Works:
package main
func main(){var s []int
s = append(s,1)}
Map的容量
● level: beginner
你可以在map创建时指定它的容量,但你无法在map上使用cap()函数。
Fails:
package main
func main(){
m := make(map[string]int,99)
cap(m)//error}
Compile Error:
/tmp/sandbox326543983/main.go:5: invalid argument m (type map[string]int)for cap
字符串不会为“nil”
● level: beginner
这对于经常使用“nil”分配字符串变量的开发者而言是个需要注意的地方。
Fails:
package main
func main(){var x string=nil//errorif x ==nil{//error
x ="default"}}
Compile Errors:
/tmp/sandbox630560459/main.go:4: cannot usenilas type stringin assignment /tmp/sandbox630560459/main.go:6: invalid operation: x ==nil(mismatched types stringandnil)
Works:
package main
func main(){var x string//defaults to "" (zero value)if x ==""{
x ="default"}}
Array函数的参数
● level: beginner
如果你是一个C或则C 开发者,那么数组对你而言就是指针。当你向函数中传递数组时,函数会参照相同的内存区域,这样它们就可以修改原始的数据。Go中的数组是数值,因此当你向函数中传递数组时,函数会得到原始数组数据的一份复制。如果你打算更新数组的数据,这将会是个问题。
package main
import"fmt"
func main(){
x :=[3]int{1,2,3}
func(arr [3]int){
arr[0]=7
fmt.Println(arr)//prints [7 2 3]}(x)
fmt.Println(x)//prints [1 2 3] (not ok if you need [7 2 3])}
如果你需要更新原始数组的数据,你可以使用数组指针类型。
package main
import"fmt"
func main(){
x :=[3]int{1,2,3}
func(arr *[3]int){(*arr)[0]=7
fmt.Println(arr)//prints &[7 2 3]}(&x)
fmt.Println(x)//prints [7 2 3]}
另一个选择是使用slice。即使你的函数得到了slice变量的一份拷贝,它依旧会参照原始的数据。
package main
import"fmt"
func main(){
x :=[]int{1,2,3}
func(arr []int){
arr[0]=7
fmt.Println(arr)//prints [7 2 3]}(x)
fmt.Println(x)//prints [7 2 3]}
在Slice和Array使用“range”语句时的出现的不希望得到的值
● level: beginner
如果你在其他的语言中使用“for-in”或者“foreach”语句时会发生这种情况。Go中的“range”语法不太一样。它会得到两个值:第一个值是元素的索引,而另一个值是元素的数据。
Bad:
package main
import"fmt"
func main(){
x :=[]string{"a","b","c"}for v := range x {
fmt.Println(v)//prints 0, 1, 2}}
Good:
package main
import"fmt"
func main(){
x :=[]string{"a","b","c"}for _, v := range x {
fmt.Println(v)//prints a, b, c}}
Slices和Arrays是一维的 *
● level: beginner
看起来Go好像支持多维的Array和Slice,但不是这样的。尽管可以创建数组的数组或者切片的切片。对于依赖于动态多维数组的数值计算应用而言,Go在性能和复杂度上还相距甚远。
你可以使用纯一维数组、“独立”切片的切片,“共享数据”切片的切片来构建动态的多维数组。
如果你使用纯一维的数组,你需要处理索引、边界检查、当数组需要变大时的内存重新分配。
使用“独立”slice来创建一个动态的多维数组需要两步。首先,你需要创建一个外部的slice。然后,你需要分配每个内部的slice。内部的slice相互之间独立。你可以增加减少它们,而不会影响其他内部的slice。
package main
func main(){
x :=2
y :=4
table := make([][]int,x)for i:= range table {
table[i]= make([]int,y)}}
使用“共享数据”slice的slice来创建一个动态的多维数组需要三步。首先,你需要创建一个用于存放原始数据的数据“容器”。然后,你再创建外部的slice。最后,通过重新切片原始数据slice来初始化各个内部的slice。
package main
import"fmt"
func main(){
h, w :=2,4
raw := make([]int,h*w)for i := range raw {
raw[i]= i
}
fmt.Println(raw,&raw[4])//prints: [0 1 2 3 4 5 6 7] <ptr_addr_x>
table := make([][]int,h)for i:= range table {
table[i]= raw[i*w:i*w w]}
fmt.Println(table,&table[1][0])//prints: [[0 1 2 3] [4 5 6 7]] <ptr_addr_x>}
关于多维array和slice已经有了专门申请,但现在看起来这是个低优先级的特性。
访问不存在的Map Keys *
● level: beginner
这对于那些希望得到“nil”标示符的开发者而言是个技巧(和其他语言中做的一样)。如果对应的数据类型的“零值”是“nil”,那返回的值将会是“nil”,但对于其他的数据类型是不一样的。检测对应的“零值”可以用于确定map中的记录是否存在,但这并不总是可信(比如,如果在二值的map中“零值”是false,这时你要怎么做)。检测给定map中的记录是否存在的最可信的方法是,通过map的访问操作,检查第二个返回的值。
Bad:
package main
import"fmt"
func main(){
x := map[string]string{"one":"a","two":"","three":"c"}if v := x["two"]; v ==""{//incorrect
fmt.Println("no entry")}}
Good:
package main
import"fmt"
func main(){
x := map[string]string{"one":"a","two":"","three":"c"}if _,ok := x["two"];!ok {
fmt.Println("no entry")}}
Strings无法修改
● level: beginner
尝试使用索引操作来更新字符串变量中的单个字符将会失败。string是只读的byte slice(和一些额外的属性)。如果你确实需要更新一个字符串,那么使用byte slice,并在需要时把它转换为string类型。
Fails:
package main
import"fmt"
func main(){
x :="text"
x[0]='T'
fmt.Println(x)}
Compile Error:
/tmp/sandbox305565531/main.go:7: cannot assign to x[0]
Works:
package main
import"fmt"
func main(){
x :="text"
xbytes :=[]byte(x)
xbytes[0]='T'
fmt.Println(string(xbytes))//prints Text}
需要注意的是:这并不是在文字string中更新字符的正确方式,因为给定的字符可能会存储在多个byte中。如果你确实需要更新一个文字string,先把它转换为一个rune slice。即使使用rune slice,单个字符也可能会占据多个rune,比如当你的字符有特定的重音符号时就是这种情况。这种复杂又模糊的“字符”本质是Go字符串使用byte序列表示的原因。
String和Byte Slice之间的转换
● level: beginner
当你把一个字符串转换为一个byte slice(或者反之)时,你就得到了一个原始数据的完整拷贝。这和其他语言中cast操作不同,也和新的slice变量指向原始byte slice使用的相同数组时的重新slice操作不同。
Go在[]byte到 string和 string到 []byte的转换中确实使用了一些优化来避免额外的分配(在todo列表中有更多的优化)。
第一个优化避免了当 []bytekey用于在 map[string]集合中查询时的额外分配: m[string(key)]。
第二个优化避免了字符串转换为 []byte后在 for range语句中的额外分配: for i,v := range []byte(str){…}。
String和索引操作
● level: beginner
字符串上的索引操作返回一个byte值,而不是一个字符(和其他语言中的做法一样)。
package main
import"fmt"
func main(){
x :="text"
fmt.Println(x[0])//print 116
fmt.Printf("%T",x[0])//prints uint8}
如果你需要访问特定的字符串“字符”(unicode编码的points/runes),使用 for range。官方的“unicode/utf8”包和实验中的utf8string包(golang.org/x/exp/utf8string)也可以用。utf8string包中包含了一个很方便的 At()方法。把字符串转换为rune的切片也是一个选项。
字符串不总是UTF8文本
● level: beginner
字符串的值不需要是UTF8的文本。它们可以包含任意的字节。只有在string literal使用时,字符串才会是UTF8。即使之后它们可以使用转义序列来包含其他的数据。
为了知道字符串是否是UTF8,你可以使用“unicode/utf8”包中的 ValidString()函数。
package main
import("fmt""unicode/utf8")
func main(){
data1 :="ABC"
fmt.Println(utf8.ValidString(data1))//prints: true
data2 :="A\xfeC"
fmt.Println(utf8.ValidString(data2))//prints: false}
字符串的长度
● level: beginner
让我们假设你是Python开发者,你有下面这段代码:
data = u'♥'print(len(data))#prints: 1
当把它转换为Go代码时,你可能会大吃一惊。
package main
import"fmt"
func main(){
data :="♥"
fmt.Println(len(data))//prints: 3}
内建的 len()函数返回byte的数量,而不是像Python中计算好的unicode字符串中字符的数量。
要在Go中得到相同的结果,可以使用“unicode/utf8”包中的 RuneCountInString()函数。
package main
import("fmt""unicode/utf8")
func main(){
data :="♥"
fmt.Println(utf8.RuneCountInString(data))//prints: 1}
理论上说 RuneCountInString()函数并不返回字符的数量,因为单个字符可能占用多个rune。
package main
import("fmt""unicode/utf8")
func main(){
data :="é"
fmt.Println(len(data))//prints: 3
fmt.Println(utf8.RuneCountInString(data))//prints: 2}
在多行的Slice、Array和Map语句中遗漏逗号
● level: beginner
Fails:
package main
func main(){
x :=[]int{1,2//error}
_ = x
}
Compile Errors:
/tmp/sandbox367520156/main.go:6: syntax error: need trailing comma before newline in composite literal /tmp/sandbox367520156/main.go:8: non-declaration statement outside function body /tmp/sandbox367520156/main.go:9: syntax error: unexpected }
Works:
package main
func main(){
x :=[]int{1,2,}
x = x
y :=[]int{3,4,}//no error
y = y
}
当你把声明折叠到单行时,如果你没加末尾的逗号,你将不会得到编译错误。
log.Fatal和log.Panic不仅仅是Log
● level: beginner
Logging库一般提供不同的log等级。与这些logging库不同,Go中log包在你调用它的 Fatal*()和 Panic*()函数时,可以做的不仅仅是log。当你的应用调用这些函数时,Go也将会终止应用
您可能感兴趣的文章:
golang url 收集
想系统学习GO语言(Golang
go html提取纯文本_Go 语言高性能编程
go语言核心编程_Go语言核心编程李文塔
Go 开发关键技术指南 | 为什么你要选择 Go?(内含超全知识大图)
golang会取代php吗
Go的50坑:新Golang开发者要注意的陷阱、技巧和常见错误
Go语言爱好者周刊:第 78 期 — 这道关于 goroutine 的题
golang 动态生成函数_GoLang的优点和缺点
Golang包管理详解