Go语言中全局变量的正确声明与赋值方式详解_技术教程

本文讲解go中全局变量在跨函数使用时的常见错误：类型不匹配（指针 vs 值类型）和变量遮蔽（局部变量覆盖全局变量），并给出修复方案及最佳实践。

在Go语言中，全局变量（即包级变量）是实现跨函数状态共享的常用方式，但其使用需严格遵循类型和作用域规则。上述代码的核心问题在于双重误用：一是全局变量 api 的类型声明与实际返回值不一致；二是函数内误用短变量声明 := 覆盖了全局变量，导致初始化失效。

问题分析

类型不匹配
github.com/ant0ine/go-json-rest/rest.NewApi() 的函数签名是：
```
func NewApi() *Api
```
它返回的是 *rest.Api（指向 rest.Api 结构体的指针），而原代码中全局变量声明为：
```
var api res
t.Api // ❌ 值类型，无法接收指针
```
类型不兼容将导致编译失败或运行时 panic（取决于Go版本与调用上下文）。
变量遮蔽（Shadowing）
在 foo() 函数中：
```
api := rest.NewApi() // ✅ 创建了新的局部变量 api，遮蔽了全局变量
```
此处 := 是短变量声明，它在函数作用域内新建了一个同名局部变量 api，而非为全局变量赋值。因此，全局 api 始终为零值（nil），后续 bar() 中调用 api.MakeHandler() 会触发 panic 或静默失败。

正确写法

需同步修正两处：

将全局变量声明为指针类型；
在 foo() 中使用赋值操作符 = 而非 :=。

package main

import (
    "github.com/ant0ine/go-json-rest/rest"
    "log"
    "net"
    "net/http"
)

type Message struct {
    Body string
}

var api *rest.Api // ✅ 改为 *rest.Api，匹配 NewApi() 返回类型

func hostLookup(w rest.ResponseWriter, req *rest.Request) {
    ip, err := net.LookupIP(req.PathParam("host"))
    if err != nil {
        rest.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    w.WriteJson(&ip)
}

func foo() {
    api = rest.NewApi() // ✅ 使用 = 赋值给全局变量，而非声明局部变量
    api.Use(rest.DefaultDevStack...)
    router, err := rest.MakeRouter(
        &rest.Route{"GET", "/lookup/#host", hostLookup},
    )
    if err != nil {
        log.Fatal(err)
    }
    api.SetApp(router)
}

func bar() {
    log.Fatal(http.ListenAndServe(":8080", api.MakeHandler()))
}

func main() {
    foo()
    bar()
}