引擎是 Gin 框架的核心组件，为 HTTP 服务器功能提供支持。它管理路由、处理 HTTP 请求并协调中间件执行。理解引擎对于使用 Gin 构建和配置 Web 应用程序至关重要。
有关请求/响应处理和每个请求状态的信息，请参阅 上下文。有关路由和路由组织详情，请参阅 RouterGroup 和路由。
Engine 结构是 Gin 框架的中央控制器。它嵌入了 RouterGroup 以继承所有路由功能，并添加了 HTTP 服务器功能以及配置选项。
引擎负责
Gin 提供了两个主要的工厂函数来创建引擎
创建一个具有默认配置但未附加中间件的基本引擎
New() 函数使用适合大多数应用程序的标准设置初始化引擎。您可以直接设置属性来进一步自定义它。
创建一个预先附加了 Logger 和 Recovery 中间件的引擎
Default() 函数是大多数应用程序推荐的启动方式，因为它提供了必要的日志记录和错误恢复功能。
来源: gin.go193-223 gin.go226-231
引擎可以通过各种字段进行配置以控制其行为
| 选项 | 默认 | 描述 |
|---|---|---|
| RedirectTrailingSlash | true | 如果存在带/不带尾部斜杠的路由，则进行重定向 |
| RedirectFixedPath | false | 尝试修复路径，删除多余的斜杠，或执行不区分大小写的查找 |
| HandleMethodNotAllowed | false | 如果方法不允许，则返回 405（而不是 404） |
| ForwardedByClientIP | true | 使用来自 X-Forwarded-For/X-Real-IP 标头的客户端 IP |
| UseRawPath | false | 使用 URL.RawPath 进行路由匹配（对于已编码的斜杠很有用） |
| UnescapePathValues | true | 对 URL 参数值进行解码 |
| MaxMultipartMemory | 32MB | 用于 multipart 表单解析的最大内存 |
创建引擎后，您可以直接配置这些选项
或者使用 `With()` 方法通过选项函数应用配置
来源: gin.go94-181 gin.go193-223 gin.go324-331
当 HTTP 请求到达时，它通过引擎的流程如下：
该流程在 `ServeHTTP` 方法中实现，该方法实现了 `http.Handler` 接口。
来源: gin.go623-633 gin.go648-714
引擎提供了几种启动 HTTP 服务器的方法
| 方法 | 描述 |
|---|---|
Run(addr ...string) | 启动一个 HTTP 服务器（默认：":8080"） |
RunTLS(addr, certFile, keyFile string) | 启动一个 HTTPS 服务器 |
RunUnix(file string) | 通过 Unix 套接字提供 HTTP 服务 |
RunFd(fd int) | 通过文件描述符提供 HTTP 服务 |
RunQUIC(addr, certFile, keyFile string) | 通过 QUIC 提供 HTTP/3 服务 |
RunListener(listener net.Listener) | 在自定义监听器上提供 HTTP 服务 |
使用示例
`Run` 方法是阻塞的，通常应该放在 `main()` 函数的最后调用。
来源: gin.go514-621
引擎通过方法树管理路由。每种 HTTP 方法（GET、POST 等）都有自己的树来优化路由查找
路由通过从 RouterGroup 继承的方法添加，如 `GET`、`POST` 等，这些方法最终调用 `addRoute` 方法
您可以通过 `Routes()` 方法获取有关所有已注册路由的信息，该方法返回每条路由的 HTTP 方法、路径和处理函数名称等详细信息。
来源: gin.go341-363 gin.go365-389
引擎提供了处理 HTML 模板的方法
| 方法 | 描述 |
|---|---|
LoadHTMLGlob(pattern string) | 使用 glob 模式加载模板 |
LoadHTMLFiles(files ...string) | 加载特定的模板文件 |
SetHTMLTemplate(templ *template.Template) | 设置预解析的模板 |
SetFuncMap(funcMap template.FuncMap) | 设置模板辅助函数 |
示例
HTML 渲染行为根据 Gin 的模式（debug/release/test）而有所不同
来源: gin.go248-295 gin.go297-300
对于位于负载均衡器或代理后面的应用程序，您可以配置要信任的代理，以确定客户端 IP 地址
引擎会检查客户端 IP 是否来自受信任的代理，然后使用 `X-Forwarded-For` 等标头来确定原始客户端 IP。
来源: gin.go420-456 gin.go445-456
引擎允许为“未找到”（404）和“方法不允许”（405）响应自定义处理程序
这些处理程序遵循与常规路由处理程序相同的中间件模式，可以执行渲染模板、重定向或返回 JSON 等复杂操作。
来源: gin.go302-306 gin.go309-313 gin.go333-339
为了性能原因，引擎维护一个上下文对象池，这些对象会在请求之间重复使用
这通过在请求之间重用对象而不是每次都创建新对象来减少垃圾回收压力。
来源： gin.go219-222 gin.go242-246 gin.go624-632
可以通过 Use() 方法向 Engine 添加中间件，这将影响所有路由
Gin 中的中间件函数签名是 func(*Context)，通过调用 c.Next() 可以在实际路由处理程序之前和之后执行操作。
来源： gin.go314-322 gin.go333-339
Engine 的行为会根据 Gin 的运行模式而变化
| 模式 | 描述 |
|---|---|
| DebugMode | 默认模式，具有详细日志（开发环境） |
| ReleaseMode | 针对生产环境进行了优化 |
| TestMode | 测试期间使用 |
您可以通过 SetMode 函数或 GIN_MODE 环境变量来设置模式
模式会影响日志记录、模板加载行为和错误展示。
Engine 是任何 Gin 应用程序的基础，它提供了一个强大而灵活的 HTTP 服务器，其中包含有助于您高效构建 Web 应用程序的功能。