企业官网建设流程全解析

TL;DR 核心要点速览

• Gin框架是Go最流行的Web框架

• gRPC适合内部服务,REST适合对外API
• JWT Token是无状态认证的标准方案
• Go标准库net/http可直接构建HTTP服务
• Swagger/OpenAPI可自动生成API文档
• 本篇是Go Web开发模块,含完整项目代码

摘要：本文详细介绍告别手写API文档,涵盖核心原理、完整代码示例和三方对比分析,适合Go后端开发者系统学习Web知识
# Swagger/OpenAPI文档自动生成:告别手写API文档

摘要: 本篇从swaggo/swag的安装和使用讲起，用注解方式自动生成Swagger文档，演示API分组、模型定义、响应描述和认证配置，分享泛型结构体注解导致文档生成错误的踩坑经历，对比swaggo与oapi-codegen两种工具的优劣。

开篇故事

我们组以前API文档用Word写，维护在共享文件夹里。每次改接口都要改代码改文档，两边经常不同步。前端同事总抱怨文档和实际返回对不上，有时候字段名变了文档还是旧的。

有一次前端按文档写好