golang新手们容易犯的3个错误总结

前言

从golang小白到成为golang工程师快两个月了，我要分享一下新手在开发中常犯的错误，都是我亲自踩过的坑。这些错误中有些会导致无法通过编译，这种错容易发现，而有些错误在编译时不会抛出，甚至在运行时也不会panic，如果缺少相关的知识，挠破头皮都搞不清楚bug出在哪。

1.对nil map、nil slice 添加数据

请考虑一下这段代码是否有错，然后运行一遍：

package main

func main() {
 var m map[string]string
 m["name"] = "zzy"
}

不出意外的话，这段代码将导致一个panic：

panic: assignment to entry in nil map

这是因为代码中只是声明了map的类型，却没有为map创建底层数组，此时的map实际上在内存中还不存在，即nil map，可以运行下面的代码进行验证：

package main

import "fmt"

func main() {
 var m map[string]string
 if m == nil {
  fmt.Println("this map is a nil map")
 }
}

所以想要顺利的使用map，一定要使用内建函数make函数进行创建：

m := make(map[string]string)

使用字面量的方式也是可以的，效果同make：

m := map[string]string{}

同样的，直接对nil slice添加数据也是不允许的，因为slice的底层也是数组，没有经过make函数初始化时，只是声明了slice类型，而底层数组是不存在的：

package main

func main() {
 var s []int
 s[0] = 1
}

上面的代码将产生一个panic runtime error:index out of range ，正确做法应该是使用make函数或者字面量：

package main

func main() {
 //第二个参数是slice的len，make slice时必须提供，还可以传入第三个参数作为cap 
 s := make([]int, 1) 
 s[0] = 1
}

可能有人发现对nil slice使用append函数而不经过make也是有效的：

package main

import "fmt"

func main() {
 var s []int
 s = append(s, 1)
 fmt.Println(s) // s => [1]
}

那是因为slice本身其实类似一个struct，它有一个len属性，是当前长度，还有个cap属性，是底层数组的长度，append函数会判断传入的slice的len和cap，如果len即将大于cap，会调用make函数生成一个更大的新数组并将原底层数组的数据复制过来（以上均为本人猜测，未经查证，有兴趣的同学可以去挑战一下源码），过程类似：

package main

import "fmt"

func main() {
 var s []int //len(s)和cap(s)都是0
 s = append(s, 1)
 fmt.Println(s) // s => [1]
}

func append(s []int, arg int) []int {
 newLen := len(s) + 1
 var newS []int
 if newLen > cap(s) {
  //创建新的slice，其底层数组扩容为原先的两倍多
  newS = make([]int, newLen, newLen*2)
  copy(newS, s)
 } else {
  newS = s[:newLen] //直接在原数组上切一下就行
 }
 newS[len(s)] = arg
 return newS
}

对nil map、nil slice的错误使用并不是很可怕，毕竟编译的时候就能发觉，下面要说的一个错误则非常坑爹，一不小心中招的话，很难排查。

2.误用:=赋值导致变量覆盖

先看下这段代码，猜猜会打印出什么：

package main

import (
 "errors"
 "fmt"
)

func main() {
 i := 2
 if i > 1 {
  i, err := doDivision(i, 2)
  if err != nil {
   panic(err)
  }
  fmt.Println(i)
 }
 fmt.Println(i)
}

func doDivision(x, y int) (int, error) {
 if y == 0 {
  return 0, errors.New("input is invalid")
 }
 return x / y, nil
}

我估计有人会认为是：

1
1

实际执行一遍，结果是：

1
2

为什么会这样呢！？

这是因为golang中变量的作用域范围小到每个词法块（不理解的同学可以简单的当成 {} 包裹的部分）都是一个单独的作用域，大家都知道每个作用域的内部声明会屏蔽外部同名的声明，而每个 if 语句都是一个词法块，也就是说，如果在某个 if 语句中，不小心用 := 而不是 = 对某个 if 语句外的变量进行赋值，那么将产生一个新的局部变量，并仅仅在 if 语句中的这个赋值语句后有效，同名的外部变量会被屏蔽，将不会因为这个赋值语句之后的逻辑产生任何变化！

在语言层面这也许并不是个错误，但是实际工作中如果误用，那么产生的bug会很隐秘。比如例子中的代码，因为 err 是之

即便 map 中元素没有以上限制，这段代码依然是错误的，想一想，为什么？答案之前已经说过了。

那么，怎么改才能正确呢，老套路，依然是使用指针：

package main

import "fmt"

type person struct {
 name string
 age byte
 isDead bool
}

func main() {
 p1 := &person{name: "zzy", age: 100}
 p2 := &person{name: "dj", age: 99}
 p3 := &person{name: "px", age: 20}
 people := map[string]*person{
  p1.name: p1,
  p2.name: p2,
  p3.name: p3,
 }
 whoIsDead(people)
 if p3.isDead {
  fmt.Println("who is dead?", p3.name)
 }
}

func whoIsDead(people map[string]*person) {
 for name, _ := range people {
  if people[name].age < 50 {
   people[name].isDead = true
  }
 }
}

另外，在 interface{} 断言里试图直接修改 struct 属性而非通过指针修改时：

package main

type person struct {
 name string
 age byte
 isDead bool
}

func main() {
 p := person{name: "zzy", age: 100}
 isDead(p)
}

func isDead(p interface{}) {
 if p.(person).age < 101 {
  p.(person).isDead = true
 }
}

会直接报一个编译错误：

cannot assign to p.(person).isDead

即便编译通过，代码也是错误的，始终要记住 struct 是值类型的数据，请使用指针去操作它，正确做法是：

package main

import "fmt"

type person struct {
 name string
 age byte
 isDead bool
}

func main() {
 p := &person{name: "zzy", age: 100}
 isDead(p)
 fmt.Println(p)
}

func isDead(p interface{}) {
 if p.(*person).age < 101 {
  p.(*person).isDead = true
 }
}

最后，不能不说golang中指针真是居家旅行、升职加薪的必备知识啊，希望同学们熟练掌握。

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对社区的支持。