本文详解 go 中全局变量（特别是接口指针类型）的声明、作用域及赋值陷阱，重点解决因局部变量遮蔽（shadowing）和类型不匹配导致的 api 初始化失败问题。
在 Go 语言中，全局变量是跨函数共享状态的重要手段，但其正确使用需严格遵循类型一致性和赋值方式两大原则。你提供的代码无法启动正常路由服务，根本原因在于对 rest.Api 类型的误解与变量作用域的误用。
首先，github.com/ant0ine/go-json-rest/rest 包中的 NewApi() 函数返回的是 *rest.Api（即指向 rest.Api 结构体的指针），而非 rest.Api 接口值本身：
// 源码示意（实际包中定义）
func NewApi() *Api { ... }因此，全局变量声明必须匹配其真实类型：
❌ 错误声明（类型不匹配）：
var api rest.Api // 声明为接口值，但 NewApi() 返回 *Api → 编译可能通过，但运行时行为异常
✅ 正确声明（指针类型）：
var api *rest.Api // 明确声明为指针类型
其次，foo() 函数中使用了短变量声明操作符 :=：
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
api := rest.NewApi() // 创建了新的局部变量 api，遮蔽（shadow）了全局变量！
这行代码并未给全局 api 赋值，而是在 foo() 函数作用域内新建了一个同名局部变量。函数退出后，该局部变量被销毁，全局 api 仍为 nil。后续调用 api.MakeHandler() 时将触发 panic 或返回无效 handler，导致 HTTP 路由完全失效。
✅ 正确写法（显式赋值给全局变量）：
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)
}完整修正后的代码如下：
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
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())) // ✅ 此时 api 已初始化
}
func main() {
foo()
bar()
}⚠️ 注意事项：
- Go 中 := 仅用于新变量声明；若左侧变量已存在（如包级变量），必须使用 = 赋值。
- 全局变量初始化应确保在所有依赖它的函数调用前完成，避免 nil 指针解引用。
- 现代 Go 项目更推荐依赖注入（如将 *rest.Api 作为参数传入 foo()）以提升可测试性，但理解全局变量机制仍是基础。
掌握类型与作用域的精确对应，是写出健壮 Go 服务的关键一步。
