Go编译报错：变量已声明未使用（实际已使用）原因排查

编写了如下Go代码：

package main

import (
    "fmt"
    "log"
    "os"
    "strconv"
)

func main() {
    numberOfUsers := 10
    numberOfUsersStr, found := os.LookupEnv("NUMBER_OF_USERS")
    if found {
        numberOfUsers, err := strconv.Atoi(numberOfUsersStr)
        if err != nil {
            log.Fatalln(err)
        }
    }
    fmt.Printf("Number of users: %d", numberOfUsers)
}

执行编译命令 go build -o app . 时，出现以下错误：

.\app.go:14:3: numberOfUsers declared but not used

问题原因 #

这是Go语言变量作用域规则导致的问题：

• 函数内的 numberOfUsers := 10 声明了一个属于main函数作用域的变量。
• 在 if found 代码块内，你使用 numberOfUsers, err := strconv.Atoi(...)，这里的 := 是短变量声明，它会在当前if代码块内重新创建一个新的 numberOfUsers 变量——这个变量和外层的同名变量是完全独立的两个实体。
• 新的 numberOfUsers 仅在if块内有效，但你在if块中没有使用它（仅完成赋值就结束了代码块），而外层的 numberOfUsers 正常被打印使用，因此编译器会提示if块内的新变量“已声明但未使用”。

修复方案 #

需要避免在if块内重新声明变量，改用赋值操作来修改外层变量，有两种常见实现方式：

方案一：提前声明err变量，使用赋值符号= #

package main

import (
    "fmt"
    "log"
    "os"
    "strconv"
)

func main() {
    numberOfUsers := 10
    numberOfUsersStr, found := os.LookupEnv("NUMBER_OF_USERS")
    if found {
        var err error
        numberOfUsers, err = strconv.Atoi(numberOfUsersStr)
        if err != nil {
            log.Fatalln(err)
        }
    }
    fmt.Printf("Number of users: %d", numberOfUsers)
}

方案二：用临时变量接收转换结果，再赋值给外层变量 #

package main

import (
    "fmt"
    "log"
    "os"
    "strconv"
)

func main() {
    numberOfUsers := 10
    numberOfUsersStr, found := os.LookupEnv("NUMBER_OF_USERS")
    if found {
        num, err := strconv.Atoi(numberOfUsersStr)
        if err != nil {
            log.Fatalln(err)
        }
        numberOfUsers = num
    }
    fmt.Printf("Number of users: %d", numberOfUsers)
}

内容的提问来源于stack exchange，提问作者Goplayer