可集成模块
19 个 ling-base 模块可选集成
在线 Playground
在浏览器中直接体验本页相关 API，无需本地安装 Go 环境。
可集成模块
lingcli create 命令支持 --modules 参数，可选集成以下 ling-base 模块：
lingcli create myapp --template web-api \
--modules apidocs,limiter,circuitbreaker,middleware,jwt,cache模块列表
| 模块 ID | 说明 | 对应 ling-base 模块 |
|---|---|---|
apidocs | API 文档 UI + OpenAPI 3.1 spec | apidocs |
limiter | 令牌桶限流 | common/limiter |
circuitbreaker | 熔断 + 超时中间件 | common/circuitbreaker |
middleware | HTTP 中间件合集 | common/middleware |
jwt | JWT 鉴权 + 登录/刷新路由 | common/jwtutil |
cache | 缓存抽象 | common/cache |
lock | 分布式锁 | common/lock |
retry | 重试策略 | common/retry |
scheduler | 分布式定时任务 | common/scheduler |
eventbus | 本地事件总线 | common/eventbus |
stats | 统计采集 | common/stats |
notification | 通知调度 | common/notification |
mq | 消息队列 | common/mq |
stores | 对象存储 | stores |
search | 全文搜索 | common/search |
bloom | 布隆过滤器 | common/bloom |
captcha | 验证码 | common/captcha |
opentelemetry | OpenTelemetry 链路追踪 | common/opentelemetry |
i18n | 国际化 | common/i18n |
生成后操作
以 web-api 模板 + jwt,cache,limiter 模块为例：
lingcli create myshop --template web-api --modules jwt,cache,limiter
cd myshop
go mod tidy
make run生成物包括：
myshop/
├── cmd/server/main.go # 入口
├── internal/handler/ # HTTP handlers
├── internal/middleware/ # JWT、限流等（由 --modules 决定）
├── configs/config.yaml
├── docker-compose.yml
└── Makefilemake test # 测试
make test-race # 竞态检测
make lint # golangci-lint
make docker-up # Docker Compose 启动