Go 变量遮蔽导致外层 err 永远为 nil 怎么排查？

Question

仓乃文 · Accepted Answer

Go 的 := 短变量声明会在当前作用域创建新变量。如果内层作用域用 := 声明了与外层同名的变量（尤其是 err），外层变量就被遮蔽了，赋值写的是内层变量，外层变量始终是零值。

经典错误：
```go
func foo() error {
    var err error
    if true {
        data, err := getData() // 新的 err，遮蔽了外层
        if err != nil {
            return err // 返回内层 err
        }
        _ = data
    }
    return err // 永远返回 nil！外层 err 从未被赋值
}
```

修复方法 1——避免嵌套，提前返回：
```go
func foo() error {
    data, err := getData() // 同一作用域
    if err != nil {
        return err
    }
    _ = data
    return nil
}
```

修复方法 2——显式赋值而非短声明：
```go
var data string
data, err = getData() // 用 = 而非 :=，复用外层 err
```

补充说明：
- go vet 可以检测部分变量遮蔽问题
- IDE 开启变量高亮和遮蔽检查是最有效的预防手段
- 规则：尽量减少嵌套层级，err 在同一作用域内复用
- 这个 bug 隐蔽性极强，因为编译不报错，运行也不报错，只是逻辑错误