《100个Go语言典型错误》精读笔记 - 意想不到的变量隐藏

典型错误1：意想不到的变量隐藏

变量隐藏问题

“

常见问题：在Go语言中，由于块级作用域的规则，块内部和外部使用相同的变量名会导致外部变量的值未如预期改变。

“

解决办法：不要在不同作用域使用相同变量名；可在块内使用一个临时变量，并在操作完成后将其值赋给外部全局变量。

在下面这段代码中，花括号 中的 变量 count 把外层的变量count给遮盖住了。导致，最后打印的count依然是0，而非期望中的1值。

package main

import "fmt"

func main() {
    // 声明一个变量用来计数
    count := 0

    // 内部作用域，声明了一个同名的变量，导致变量阴影
    if count == 0 {
        count := 1 // 这里使用了相同的变量名，创建了一个新的局部变量
        fmt.Println("Inside if:", count) // 这将打印 "Inside if: 1"
    }

    // 尝试打印外部作用域的变量值
    fmt.Println("Outside if:", count) // 这将打印 "Outside if: 0"
}

在Go语言中，这叫变量隐藏。变量隐藏（Variable Shadowing）是指在内部作用域中声明了一个与外部作用域同名的变量，导致外部变量被内部变量遮盖的现象。这种隐藏关系可能会导致代码出现不易察觉的错误。

变量隐藏相关知识

• 知识点1：Go语言中，变量的作用域是块级的。

{
    var a int = 10
}
fmt.Println(a) //a变量在花括号外面是不可用的

• 知识点2：不同块级可以用相同的变量名

var a int = 10
{
    var a string = "Hello World"
    fmt.Println(a) //输出字符串 Hello World
}

fmt.Println(a) //输出整型 10

• 知识点3：Go语言中，短变量声明操作符 := 是将变量声明和变量赋值合并在一起的，虽然简单，但也容易出错。

var a int = 10
{
    a := "Hello World" // := 操作符 将赋值和变量声明合二为一
}

本质上，由于Go语言的这种特性，导致在不同块级的变量名容易造成混淆，从而产生代码逻辑错误。

如何避免变量隐藏

为了避免这种情况，可以采取以下措施：

1. 使用不同的变量名。

2. 使用临时变量接收函数返回值，然后将其赋值给外部变量。

3. 不使用短变量声明操作符 :=

修改后的代码如下：

package main

import "fmt"

func main() {
    // 声明一个变量用来计数
    count := 0

    // 内部作用域，使用不同的变量名
    if count == 0 {
        increment := 1 // 使用不同的变量名
        fmt.Println("Inside if:", increment) // 这将打印 "Inside if: 1"
    }

    // 打印外部作用域的变量值
    fmt.Println("Outside if:", count) // 这将正确地打印 "Outside if: 0"
}

在这个修改后的版本中，我们使用了一个临时变量 tempClient 来接收函数的返回值，然后将其赋值给外层作用域的变量，从而避免了变量隐藏的问题。

下一节，介绍代码层次嵌套过多带来的问题以及解决方案。