搭建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./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 框架
不需要重
量级框架也能快速起步。推荐两种常见组合：
-
标准库 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"}，再逐步加功能。
量级框架也能快速起步。推荐两种常见组合：