GoFrame首个Hello World项目需四步:1. 用go install安装gf CLI;2. gf init初始化项目(注意目录与命名规范);3. 修改config.yaml中server.address端口避免冲突;4. gf run启动后访问/hello路由验证响应。

想用GoFrame快速跑通第一个Hello World项目,从零开始初始化、配置端口、启动服务并验证响应,整个流程必须避开init命令不建目录、端口冲突、依赖未更新等常见卡点。
安装gf命令行工具
打开终端,执行go install github.com/gogf/gf/v2/cmd/gf@latest安装CLI工具。这一步必须做,不能跳过go get旧方式——后者已弃用,会导致后续gf init报“command not found”。
安装完成后运行gf version,看到类似GoFrame CLI Tool v2.9.6的输出才算成功。
初始化项目骨架
在空文件夹中执行gf init demo,项目名必须是新目录名,不能是已存在目录的路径。如果当前目录已有内容,改用gf init .(注意末尾是英文句点),否则会在当前目录下再建一层demo,造成嵌套混乱。
【项目名不能含大写字母或特殊符号】,否则后续生成的包名会非法,编译直接失败。
初始化完成后,进入demo目录,你会看到标准结构:config/、internal/、main.go等。此时不要手动删.gitkeep文件——它虽无功能,但删除后某些CI流程会因目录为空报错。
确认并修改HTTP服务端口
打开config/config.yaml,找到server.address这一行,默认值是":8000"。如果你本地8000端口已被占用,直接改成":8199"或其它可用端口——这一步必须改,否则gf run启动时会卡住无响应,也不报错。
保存文件后,在终端运行gf run main.go。看到终端输出Server started on :8199(或你设的端口)和ROUTE /hello字样,说明服务已就绪。
访问接口验证运行效果
打开浏览器,访问http://127.0.0.1:8199/hello(端口需与上一步一致)。页面显示Hello World!即成功。
如果返回404,请检查是否误访问了根路径/——默认路由只注册了/hello,不是/。
如果连接被拒绝,回到终端看是否有listen tcp :8199: bind: address already in use提示,说明端口仍被占,需换端口重试。

















