首先安装go并配置环境,启用Go Modules后创建项目目录并初始化;接着使用gin框架搭建路由,编写基础API接口;然后按功能组织项目结构,引入中间件处理跨域等需求;最后通过air实现热重载,提升开发效率。

在golang中快速搭建REST api开发环境,关键在于选择轻量工具、合理组织项目结构,并使用成熟框架提升效率。下面从初始化项目到运行一个基础API服务,一步步说明如何高效准备开发环境。
安装Go并配置基础环境
确保本地已安装Go语言环境(建议1.18+版本),可通过终端执行go version确认。若未安装,前往官网下载对应系统版本。
设置工作路径,推荐启用Go Modules以管理依赖:
- 执行go env -w GO111MODULE=on开启模块支持
- 新建项目目录,如mkdir myapi && cd myapi
- 运行go mod init myapi生成go.mod文件
选用Gin框架快速构建路由
Gin 是Go中流行的高性能Web框架,适合快速开发rest api。安装方式简单:
立即学习“go语言免费学习笔记(深入)”;
go get -u github.com/gin-gonic/gin
package main import "github.com/gin-gonic/gin" func main() { r := gin.Default() r.GET("/ping", func(c *gin.Context) { c.jsON(200, gin.H{"message": "pong"}) }) r.Run(":8080") }
保存后执行go run main.go,访问http://localhost:8080/ping即可看到返回json。
添加常用中间件和项目结构
为便于维护,建议按功能划分目录。例如:
myapi/ ├── go.mod ├── main.go ├── handler/ │ └── user_handler.go ├── router/ │ └── routes.go └── middleware/ └── logger.go
可引入中间件增强能力,比如跨域支持:
go get -u github.com/gin-contrib/cors
在main.go中注册:
r.Use(cors.Default())
使用Air实现热重载提升效率
开发过程中频繁手动重启服务影响体验。使用Air可实现代码变更自动重启。
- 安装Air:go install github.com/cosmtrek/air@latest
- 在项目根目录创建.air.toml配置监听范围
- 运行air启动热更新服务
此后修改代码会自动生效,无需手动重启。
基本上就这些。一套高效REST API开发环境已在本地就绪,集成路由、热重载和结构化设计,可立即投入业务开发。不复杂但容易忽略细节,保持简洁才能快速迭代。


