本文讲解go中全局变量在跨函数使用时的常见错误：类型不匹配（指针 vs 值类型）和变量遮蔽（局部变量覆盖全局变量），并给出修复方案及最佳实践。
在Go语言中，全局变量（即包级变量）是实现跨函数状态共享的常用方式，但其使用需严格遵循类型和作用域规则。上述代码的核心问题在于双重误用：一是全局变量 api 的类型声明与实际返回值不一致；二是函数内误用短变量声明 := 覆盖了全局变量，导致初始化失效。
问题分析
-
类型不匹配
github.com/ant0ine/go-json-rest/rest.NewApi() 的函数签名是：func NewApi() *Api
它返回的是 *rest.Api（指向 rest.Api 结构体的指针），而原代码中全局变量声明为：
var api rest.Api // ❌ 值类型，无法接收指针
类型不兼容将导致编译失败或运行时 panic（取决于Go版本与调用上下文）。
立即学习“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()
}注意事项与最佳实践
- ✅ 始终检查函数返回类型：使用 go doc 或 IDE 提示确认 NewApi() 等构造函数的返回值是否为指针。
- ✅ 避免在函数内用 := 初始化同名全局变量：若需赋值，显式使用 =；若需声明新变量，请使用不同名称。
- ⚠️ 全局变量应谨慎使用：虽适用于简单服务初始化，但在大型项目中建议通过依赖注入（如传参或结构体字段）提升可测试性与可维护性。
- ? 启用静态检查工具：go vet 可检测部分变量遮蔽问题；staticcheck 等工具能进一步识别未使用的全局变量或可疑赋值。
修复后，api 全局变量被正确初始化并贯穿 foo() 与 bar()，HTTP 路由将正常注册并响应请求。理解 Go 的变量作用域与类型系统，是写出健壮、可维护服务代码的关键基础。
