搭建Golang API开发环境只需安装Go、配置环境变量、启用Go Modules、选择VS Code配Go和REST Client插件、用net/http+chi或gin快速启动服务,并添加swag文档、viper配置、zerolog日志及air热重载即可。

搭建 Golang API 开发环境其实不复杂,核心是装好 Go、选对工具链、配好基础依赖管理,再搭个轻量 HTTP 服务框架即可跑起来。
安装 Go 运行时与配置环境变量
从官网 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统版本(推荐最新稳定版,如 go1.22.x),安装后验证是否生效:
- 终端执行 go version 看输出是否含版本号
- 检查 GOROOT(Go 安装路径)和 GOBIN(可执行文件目录)是否自动设置;若没设,手动加入 shell 配置(如 ~/.zshrc):
export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH - 启用 Go Modules(默认已开启):确认 GO111MODULE=on,避免 GOPATH 旧模式干扰
选择编辑器与基础开发插件
VS Code 是最常用选择,装好以下扩展即可高效写 API:
- Go 扩展(by Go Team):提供语法高亮、自动补全、跳转定义、格式化(gofmt)、测试运行等
- REST Client(by Huachao Mao):直接在 .http 文件里发请求,调试接口不用切 Postman
- 可选:GitLens 查看代码变更,Todo Tree 快速定位待办
初始化项目并引入 Web 框架
不需要重量级框架也能快速起步。推荐两种常见组合:
基于ThinkPhp6+ swoole4+uniapp 开发的一套CRMEB新零售多商户商城系统。如果不会搭建请到 查看搭建说明系统环境推荐 使用 宝塔配置环境centos PHP7.3 mysql5.6新增功能: 01·新增支持销售虚拟产品自动发货 02.支持销售链接与卡密可导入导出 03.自定义后台路径对后台进行保护 04.新增支持商家缴纳保证金功能 05·违法或侵权商品一键举报功能 06·仲
立即学习“go语言免费学习笔记(深入)”;
-
标准库 net/http + chi 或 gorilla/mux:轻量可控,适合学习或中小项目
示例:创建 main.go,用 chi 路由:
go mod init myapi
go get github.com/go-chi/chi/v5
// 然后写路由、handler、启动服务 -
gin-gonic/gin:上手快、中间件丰富、日志和错误处理友好
go get -u github.com/gin-gonic/gin
启动一行代码:r := gin.Default()
添加基础开发支持能力
一个可维护的 API 项目还需几个“脚手架”支撑:
- API 文档:用 swag(集成 Swagger)自动生成文档,加注释即可生成 docs/ 目录
- 配置管理:用 spf13/viper 支持 JSON/TOML/YAML 配置,区分 dev/prod 环境
- 日志与错误处理:标准 log 包够用,进阶可用 zerolog 或 slog(Go 1.21+ 内置)
-
本地热重载:开发时用 air(
go install github.com/cosmtrek/air@latest),改代码自动重启服务
基本上就这些。环境搭好后,一个带路由、JSON 响应、简单中间件的 API 十分钟内就能跑起来。关键是别堆太多工具,先让 http.HandleFunc 或 gin.GET 返回 {"hello": "world"},再逐步加功能。









