Loading [MathJax]/jax/input/TeX/config.js
前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >Golang 新手要注意的陷阱和常见错误(一)[通俗易懂]

Golang 新手要注意的陷阱和常见错误(一)[通俗易懂]

作者头像
全栈程序员站长
发布于 2022-02-17 05:15:43
发布于 2022-02-17 05:15:43
37600
代码可运行
举报
运行总次数:0
代码可运行

大家好,又见面了,我是全栈君。

Go 是一门简单有趣的语言,但与其他语言类似,它会有一些技巧。。。这些技巧的绝大部分并不是 Go 的缺陷造成的。如果你以前使用的是其他语言,那么这其中的有些错误就是很自然的陷阱。其它的是由错误的假设和缺少细节造成的。

如果你花时间学习这门语言,阅读官方说明、wiki、邮件列表讨论、大量的优秀博文和 Rob Pike 的展示,以及源代码,这些技巧中的绝大多数都是显而易见的。尽管不是每个人都是以这种方式开始学习的,但也没关系。如果你是 Go 语言新人,那么这里的信息将会节约你大量的调试代码的时间。

一. 初级篇

1. 开大括号不能放在单独的一行

在大多数其他使用大括号的语言中,你需要选择放置它们的位置。Go 的方式不同。你可以为此感谢下自动分号的注入(没有预读)。是的, Go 中也是有分号的:-) 失败的例子:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main()  
{ //error, can't have the opening brace on a separate line
    fmt.Println("hello there!")
}

编译错误:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox826898458/main.go:6: syntax error: unexpected semicolon or newline before {

有效的例子:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main() {  
    fmt.Println("works!")
}

2. 未使用的变量

如果你有未使用的变量,代码将编译失败。当然也有例外。在函数内一定要使用声明的变量,但未使用的全局变量是没问题的。 如果你给未使用的变量分配了一个新的值,代码还是会编译失败。你需要在某个地方使用这个变量,才能让编译器愉快的编译。 Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
var gvar int //not an error
func main() {  
    var one int   //error, unused variable
    two := 2      //error, unused variable
    var three int //error, even though it's assigned 3 on the next line
    three = 3     
}

Compile Errors:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox473116179/main.go:6: one declared and not used
/tmp/sandbox473116179/main.go:7: two declared and not used
/tmp/sandbox473116179/main.go:8: three declared and not used

Works:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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
}

另一个选择是注释掉或者移除未使用的变量

3. 未使用的 import

如果你引入一个包,而没有使用其中的任何函数、接口、结构体或者变量的话,代码将会编译失败。 你可以使用 goimports 来增加引入或者移除未使用的引用:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
$ go get golang.org/x/tools/cmd/goimports

如果你真的需要引入的包,你可以添加一个下划线标记符 _ ,来作为这个包的名字,从而避免编译失败。下滑线标记符用于引入,但不使用。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import (
    "fmt"
    "log"
    "time"
)
func main() {
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Compile Errors:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox627475386/main.go:4: imported and not used: "fmt"
/tmp/sandbox627475386/main.go:5: imported and not used: "log"
/tmp/sandbox627475386/main.go:6: imported and not used: "time"

Works:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import (
    _ "fmt"
    "log"
    "time"
)
var _ = log.Println
func main() {
    _ = time.Now
}

另一个选择是移除或者注释掉未使用的 import

4. 简式的变量声明仅可以在函数内部使用

Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
myvar := 1 //error
func main() {
}

Compile Error:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox265716165/main.go:3: non-declaration statement outside function body

Works:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
var myvar = 1
func main() {
}

5. 使用简式声明重复声明变量

你不能在一个单独的声明中重复声明一个变量,但在多变量声明中这是允许的,其中至少要有一个新的声明变量。 重复变量需要在相同的代码块内,否则你将得到一个隐藏变量。 Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    one := 0
    one := 1 //error
}

Compile Error:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox706333626/main.go:5: no new variables on left side of :=
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Works:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    one := 0
    one, two := 1,2
    one,two = two,one
}

6. 偶然的变量隐藏 Accidental Variable Shadowing

短式变量声明的语法如此的方便(尤其对于那些使用过动态语言的开发者而言),很容易让人把它当成一个正常的分配操作。如果你在一个新的代码块中犯了这个错误,将不会出现编译错误,但你的应用将不会做你所期望的事情。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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)
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
即使对于经验丰富的Go开发者而言,这也是一个非常常见的陷阱。这个坑很容易挖,但又很难发现。

你可以使用 vet 命令来发现一些这样的问题。默认情况下, vet不会执行这样的检查,你需要设置 -shadow参数: go tool vet -shadow your_file.go

7. 不使用显式类型,无法使用“nil”来初始化变量

nil 标志符用于表示 interface 、函数、 mapssliceschannels 的“零值”。如果你不指定变量的类型,编译器将无法编译你的代码,因为它猜不出具体的类型。 Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    var x = nil //error
    _ = x
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Compile Error:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox188239583/main.go:4: use of untyped nil

Works:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    var x interface{} = nil
    _ = x
}

8. 使用“nil” Slices and Maps

在一个 nilslice 中添加元素是没问题的,但对一个 map 做同样的事将会生成一个运行时的 panic 。 Works:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    var s []int
    s = append(s,1)
}

Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    var m map[string]int
    m["one"] = 1 //error
}

9. map的容量

你可以在 map 创建时指定它的容量,但你无法在 map 上使用 cap() 函数。 Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    m := make(map[string]int,99)
    cap(m) //error
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Compile Error:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox326543983/main.go:5: invalid argument m (type map[string]int) for cap

10. 字符串不会为nil

这对于经常使用 nil 分配字符串变量的开发者而言是个需要注意的地方。 Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    var x string = nil //error
    if x == nil { //error
        x = "default"
    }
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Compile Errors:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox630560459/main.go:4: cannot use nil as type string in assignment /tmp/sandbox630560459/main.go:6: invalid operation: x == nil (mismatched types string and nil)
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Works:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    var x string //defaults to "" (zero value)
    if x == "" {
        x = "default"
    }
}

11. array 函数的参数

如果你是一个 C 或则 C++ 开发者,那么数组对你而言就是指针当你向函数中传递数组时,函数会参照相同的内存区域,这样它们就可以修改原始的数据

Go 中的数组是数值,因此当你向函数中传递数组时,函数会得到原始数组数据的一份复制。如果你打算更新数组的数据,这将会是个问题。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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])
}

如果你需要更新原始数组的数据,你可以使用数组指针类型。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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 变量的一份拷贝,它依旧会参照原始的数据。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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]
}

12. 在 slice 和 array 使用“range”语句时的出现的不希望得到的值

如果你在其他的语言中使用 for-in 或者 foreach 语句时会发生这种情况。Go 中的 range 语法不太一样。它会得到两个值:第一个值是元素的索引,而另一个值是元素的数据。 Bad:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main() {
    x := []string{"a","b","c"}
    for v := range x {
        fmt.Println(v) //prints 0, 1, 2
    }
}

Good:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main() {
    x := []string{"a","b","c"}
    for _, v := range x {
        fmt.Println(v) //prints a, b, c
    }
}

13. slices 和 arrays 是一维的

看起来 Go 好像支持多维的 ArraySlice ,但不是这样的。尽管可以创建数组的数组或者切片的切片。对于依赖于动态多维数组的数值计算应用而言, Go 在性能和复杂度上还相距甚远。

你可以使用纯一维数组、“独立”切片的切片,“共享数据”切片的切片来构建动态的多维数组。 如果你使用纯一维的数组,你需要处理索引、边界检查、当数组需要变大时的内存重新分配。

使用“独立” slice 来创建一个动态的多维数组需要两步。首先,你需要创建一个外部的 slice 。然后,你需要分配每个内部的 slice 。内部的 slice 相互之间独立。你可以增加减少它们,而不会影响其他内部的 slice

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
func main() {
    x := 2
    y := 4
    table := make([][]int,x)
    for i:= range table {
        table[i] = make([]int,y)
    }
}

使用“共享数据” sliceslice 来创建一个动态的多维数组需要三步。首先,你需要创建一个用于存放原始数据的数据“容器”。然后,你再创建外部的 slice 。最后,通过重新切片原始数据 slice 来初始化各个内部的 slice

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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>
}

关于多维 arrayslice 已经有了专门申请,但现在看起来这是个低优先级的特性。

14. 访问不存在的 map keys

这对于那些希望得到 nil 标示符的开发者而言是个技巧(和其他语言中做的一样)。如果对应的数据类型的“零值”是 nil ,那返回的值将会是 nil ,但对于其他的数据类型是不一样的。检测对应的“零值”可以用于确定 map 中的记录是否存在,但这并不总是可信(比如,如果在二值的 map 中“零值”是 false ,这时你要怎么做)。检测给定 map 中的记录是否存在的最可信的方法是,通过 map 的访问操作,检查第二个返回的值。 Bad:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
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:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main() {
    x := map[string]string{"one":"a","two":"","three":"c"}
    if _,ok := x["two"]; !ok {
        fmt.Println("no entry")
    }
}

15. Strings 无法修改

尝试使用索引操作来更新字符串变量中的单个字符将会失败。string 是只读的 byte slice (和一些额外的属性)。如果你确实需要更新一个字符串,那么使用 byte slice ,并在需要时把它转换为 string 类型。 Fails:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main() {
    x := "text"
    x[0] = 'T'
    fmt.Println(x)
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
Compile Error:
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
/tmp/sandbox305565531/main.go:7: cannot assign to x[0]

Works:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
package main
import "fmt"
func main() {
    x := "text"
    xbytes := []byte(x)
    xbytes[0] = 'T'
    fmt.Println(string(xbytes)) //prints Text
}
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
需要注意的是:这并不是在文字 string 中更新字符的正确方式,因为给定的字符可能会存储在多个 byte 中。如果你确实需要更新一个文字 string ,先把它转换为一个 rune slice 。

即使使用 rune slice ,单个字符也可能会占据多个 rune ,比如当你的字符有特定的重音符号时就是这种情况。这种复杂又模糊的“字符”本质是 Go 字符串使用 byte 序列表示的原因。

发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/111715.html原文链接:https://javaforall.cn

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
暂无评论
推荐阅读
编辑精选文章
换一批
Go 常见错误
":=" 是在声明和初始化变量,因此该变量必须是第一次出现, 声明和赋值必须是一气呵成的,不能写成先声明后赋值这种形式,这个必须在函数体内才行。
羊羽shine
2019/05/29
6270
Golang 需要避免踩的 50 个坑(一)
Go 是一门简单有趣的编程语言,与其他语言一样,在使用时不免会遇到很多坑,不过它们大多不是 Go 本身的设计缺陷。如果你刚从其他语言转到 Go,那这篇文章里的坑多半会踩到。
aoho求索
2019/03/07
1.8K0
Golang 新手可能会踩的 50 个坑【转】
译文:https://github.com/wuYin/blog/blob/master/50-shades-of-golang-traps-gotchas-mistakes.md
landv
2018/11/23
2K0
​go语言的31个坑
在其他大多数语言中,{的位置你自行决定。Go比较特别,遵守分号注入规则(automatic semicolon injection):编译器会在每行代码尾部特定分隔符后加;来分隔多条语句,比如会在 )后加分号:
阿兵云原生
2023/02/16
7640
问道Golang,6月龄必知必会(二)
值类型包括:所有integer、所有float、bool、string、数组和structure
有态度的马甲
2023/04/27
2340
问道Golang,6月龄必知必会(二)
golang 学习笔记
go语言完整的定义的变量的方法为 var 变量名 类型=值,var name string ="fuwei",可以简写为name:="fuwei"(这种只能在函数内使用,无法再包内使用),
付威
2021/05/06
1.1K0
Go语法指南
出处---Go编程语言 欢迎来到 Go 编程语言指南。本指南涵盖了该语言的大部分重要特性 Go 语言的交互式简介,它分为三节。第一节覆盖了基本语法及数据结构,第二节讨论了方法与接口, 第三节则简单介绍了 Go 的并发原语。每节末尾都有几个练习,你可以对自己的所学进行实践。 你可以 在线学习 或 安装到本地。 Go基础语法,方便查阅 包、变量和函数 学习 Go 程序的基本组件 1.包 每个 Go 程序都是由包组成的。 程序运行的入口是包 main。 这个程序使用并导入了包 "fmt" 和 "math/rand
spilledyear
2022/05/13
1.2K0
Go语法指南
如何理解 golang nil
golang 中的 nil 是不同于其他语言的,为了更好的理解 nil,在此我将尝试一步一步揭示 nil 在 golang 中的一些操作和现象。 1. nil 是不能比较的 code-1 Play package main import ( "fmt" ) func main() { fmt.Println(nil==nil) } code-1 输出 tmp/sandbox318449491/main.go:8: invalid operation: nil == nil
李海彬
2018/03/27
7230
golang新手容易犯的3个错误
这是因为代码中只是声明了map的类型,却没有为map创建底层数组,此时的map实际上在内存中还不存在,即nil map,可以运行下面的代码进行验证:
李海彬
2018/09/29
1.4K0
golang新手容易犯的3个错误
Golang高效实践之泛谈篇
我博客之前的Golang高效实践系列博客中已经系统的介绍了Golang的一些高效实践建议,例如:《Golang高效实践之interface、reflection、json实践》、《Golang 高效实践之defer、panic、recover实践》、《Golang 高效实践之并发实践context篇》、《Golang 高效实践之并发实践channel篇》,本文将介绍一些零散的Golang高效实践建议,虽然琐碎但是比较重要。
用户2937493
2019/08/29
4620
golang 基础编程
map 是一种无序的键值对, 它是数据结构 hash 表的一种实现方式,类似 Python 中的字典
全栈程序员站长
2022/07/19
1.2K0
golang 基础编程
Go 语言常见错误——数据类型
在 Go 语言的开发中,常见的错误往往隐藏在细节之中,稍不注意就会引发严重的逻辑问题或性能瓶颈。正所谓千里之堤毁于蚁穴,这些看似不起眼的小问题,可能会让整个项目功亏一篑。本文涵盖了八进制字面量的误解、整数溢出的忽视、浮点数比较的陷阱、slice 和 map 的误用,以及内存泄漏和值比较的问题。通过实际的代码示例和详细解析,我们揭示了这些错误的潜在影响,并提供了最佳实践解决方案。
FunTester
2025/03/03
640
Go 语言常见错误——数据类型
golang面试题(带答案)[通俗易懂]
注:引用就是同一份,相当于起了一个别名,就是多起了一个名字而已。 在Go语言中的引用类型有:映射(map),数组切片(slice),通道(channel),方法与函数。 整型,字符串,布尔,数组在当作参数传递时,是传递副本的内存地址,也就是值传递。 2.下面代码输出什么,为什么
全栈程序员站长
2022/09/07
1.4K0
Go语言常见的坑
这里列举的Go语言常见坑都是符合Go语言语法的,可以正常的编译,但是可能是运行结果错误,或者是有资源泄漏的风险。
冬夜先生
2021/09/03
5850
golang学习笔记之一 - 基础知识与概念
go中字符称为rune,等价于C中的char,可直接与整数转换。rune实际是整型,必需先将其转换为string才能打印出来,否则打印出来的是一个ascii整数
躺平程序员老修
2023/09/05
2340
[Go] Golang 学习随笔
闭包函数的特性存在于很多高级语言中。简而言之:如果函数A的返回值也是一个函数L,其作为返回值的函数L使用了这个函数A所创建的某个局部变量,并把对这个局部变量的控制能力(使用权)提供给了外部的某个函数B,就会产生所谓的闭包。
赤道企鹅
2022/08/01
3990
[Go] Golang 学习随笔
Google资深工程师深度讲解Go语言-内建容器(三)[通俗易懂]
发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/111729.html原文链接:https://javaforall.cn
全栈程序员站长
2022/07/12
2160
Google资深工程师深度讲解Go语言-内建容器(三)[通俗易懂]
Go语言基础速刷手册
这个“不务正业”的阿巩,今天冒着现学现卖的风险来和大家分享Go了,作为既具备C的理念又有Python 姿态的语言,怎么能不来试上一试呢!
才浅Coding攻略
2022/12/12
9110
Go 中几种常见的编程模式
模式可以理解成最佳实践,或者是约定俗成的规范或套路,熟悉一些常见模式可以方便理解项目代码。本文是参考左耳朵耗子的专栏文章做的笔记,另外也缅怀一下耗子叔。
菜皮日记
2023/12/18
1570
Go 中几种常见的编程模式
[Golang]深入了解Golang的NIL机制
今天笔试题遇到 var x string = nil ,问这个定义是否正确?这里给出答案:cannot use nil as string value in variable declaration。
宇宙无敌暴龙战士之心悦大王
2023/03/30
5120
相关推荐
Go 常见错误
更多 >
领券
💥开发者 MCP广场重磅上线!
精选全网热门MCP server,让你的AI更好用 🚀
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档
本文部分代码块支持一键运行,欢迎体验
本文部分代码块支持一键运行,欢迎体验