一个基于 Gin 的最小可运行示例,包含:
- 路由分组(
/v1、/v2) - 简单登录接口(
POST /v1/login、POST /v2/login) - 中间件鉴权示例(
/v2分组) - 使用 Air 的本地热重载开发
- Go
1.25.6(与go.mod对齐)
- 安装依赖
go mod tidy- 直接运行
go run main.go默认监听:http://127.0.0.1:8080
无鉴权,返回:
{"action":"login"}经过 AuthRequired 中间件,当前示例会直接返回 403:
{"msg":"你没有权限"}本项目已包含 .air.toml 配置,关键行为:
- 编译命令:
go build -o ./tmp/main . - 运行入口:
./tmp/main - 构建日志:
tmp/build-errors.log - 监听扩展:
go,tpl,tmpl,html
go install github.com/air-verse/air@latest确保你的 $GOPATH/bin(或 $(go env GOPATH)/bin)在 PATH 中。
airAir 启动后会根据 .air.toml 自动编译并运行项目,代码变更后自动重启。
- 已通过
.gitignore忽略本地产物(如tmp/、日志、环境文件) - 建议在首次提交前执行:
git init
git add .
git commit -m "init: gin quickstart with air"然后在 GitHub 创建仓库并推送即可。