GoFrame环境验证需依次执行gf init mydemo -u创建项目、确认main.go含g.Server()及GET路由、gf run main.go启动服务并访问http://127.0.0.1:8000显示“Hello GoFrame!”,最后gf build验证编译可用。

完成GoFrame框架安装后,需要通过一个可运行的最小Demo验证环境是否真正就绪,避免后续开发中因基础配置缺失导致接口无法启动、路由不响应或日志无输出等问题。
初始化一个标准项目骨架
在任意空目录下执行命令:
gf init mydemo -u
该命令会生成符合GoFrame v2约定的完整项目结构,包含config/、internal/、api/、main.go等标准目录。注意:-u参数确保拉取最新版框架模板,若省略可能导致生成的配置文件缺少v2.9+新增字段(如log.level字段)。
执行后检查当前目录是否出现mydemo文件夹,进入该目录:【cd mydemo】
确认main.go已具备可运行HTTP服务
打开mydemo/main.go文件,确认内容以g.Server()或ghttp.NewServer()开头,并包含至少一条GET路由注册。标准模板默认已写好:
s := g.Server()
s.GET("/", func(r *ghttp.Request) { r.Response.Write("Hello GoFrame!") })
s.Run()
若文件为空或仅含package main而无服务启动逻辑,则说明gf init未成功,需重新执行并检查终端是否有“error: failed to fetch template”类报错。
启动服务并验证响应
在mydemo目录下执行:
gf run main.go
等待终端输出类似“[INFO] Server started on [:8000]”的日志行。此时服务已在本地8000端口监听。
打开浏览器访问 http://127.0.0.1:8000,页面应直接显示纯文本“Hello GoFrame!”。若返回404或连接被拒绝,请检查:①终端是否仍在运行gf run进程;②防火墙是否拦截了8000端口;③是否误将GO111MODULE设为off导致依赖未加载。
Ctrl+C终止服务后,再执行gf build main.go生成二进制可执行文件,运行./main(Linux/macOS)或 main.exe(Windows),同样访问8000端口验证——这一步确认编译链路也通畅。











