Golang 中的 err shadowing 问题

今天编译代码时遇到了这个问题，记录一下。

在一个函数中，给返回的 error 定义了名称。这个函数定义类似下面这样：

func foo(a string) (err error) {
    res, err := bar(a)
    if err != nil {
        return
    }
    
    // do anything else
    
    return
}

编译时会报这样的错误：

../../../../server/init.go:455:4: err is shadowed during return

这个问题很容易被忽略，返回的错误意思是函数在 return 时，err 被覆盖了，被谁覆盖了？

本来在调用 bar 函数发生错误时，应该返回的是当前发生的错误，但由于返回值中定义了错误名称，所以返回的是外面函数返回值中定义的 err，而不是 if err != nil 里这个 err，这样应当返回的错误就被外面那个 err 给覆盖了。

如果还要用这种定义返回值名称的方式，可以显式的返回 if 中的错误：

func foo(a string) (err error) {
    res, err := bar(a)
    if err != nil {
        return err
    }
    
    // do anything else
    
    return
}

不过这种写法还是没有在函数内部显式的声明变量来的直观：

func foo(a string) error {
    res, err := bar(a)
    if err != nil {
        return err
    }
    
    // do anything else
    
    return nil
}