本文详解 go 中全局变量（特别是接口指针类型）的声明、
作用域
及赋值陷阱，重点解决因局部变量遮蔽（shado
win
g）和类型不匹配导致的 api 初始化失败问题。
在 Go 语言中，全局变量是跨函数共享状态的重要手段，但其正确使用需严格遵循
类型一致性
和
赋值方式
两大原则。你提供的代码无法启动正常
路由
服务，根本原因在于对 rest.Api 类型的误解与变量作用域的误用。
首先，
git
hub.com/ant0ine/go-
js
on-rest/rest 包中的 NewApi() 函数返回的是 *rest.Api（即指向 rest.Api 结构体的指针），而非 rest.Api 接口值本身：
因此，全局变量声明必须匹配其真实类型：
❌ 错误声明（类型不匹配）：
✅ 正确声明（指针类型）：
其次，foo() 函数中使用了短变量声明操作符 :=：
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。
下载
这行代码
并未给全局 api 赋值
，而是在 foo() 函数作用域内新建了一个同名局部变量。函数退出后，该局部变量被销毁，全局 api 仍为 nil。后续调用 api.MakeHandler() 时将触发 panic 或返回无效 handler，导致 HTTP 路由完全失效。
✅ 正确写法（显式赋值给全局变量）：
完整修正后的代码如下：
⚠️ 注意事项：
Go 中 := 仅用于
新变量声明
；若左侧变量已存在（如包级变量），必须使用 = 赋值。
全局变量初始化应确保在所有依赖它的函数调用前完成，避免 nil 指针解引用。
现代 Go 项目更推荐依赖注入（如将 *rest.Api 作为参数传入 foo()）以提升可测试性，但理解全局变量机制仍是基础。
掌握类型与作用域的精确对应，是写出健壮 Go 服务的关键一步。
// 源码示意（实际包中定义）
func NewApi() *Api { ... }var api rest.Api // 声明为接口值，但 NewApi() 返回 *Api → 编译可能通过，但运行时行为异常var api *rest.Api // 明确声明为指针类型api := rest.NewApi() // 创建了新的局部变量 api，遮蔽（shadow）了全局变量！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()
}