🎓 教程

🖥 只想在命令行查 IP？

本节面向 Go SDK 库开发（在程序里嵌入 ipapi）。如果你只想在终端查询 IP，无需写代码 —— 见 CLI 快速开始。

循序渐进的实战教程。从第一个查询到生产级集成。

🎨 一图抵千言

下面这张图是整个教程的学习路径：从入门第一个查询，到错误校验、配置认证、数据格式，再到实战集成与测试，逐步打怪升级。

🌳 教程分类树

按主题与难度组织，挑你最需要的切入。

🌱 入门

教程	关键产出	推荐前置
第一个 IP 查询	跑通第一次 GetIPInfo	无
创建你的第一个 Client	理解 NewClient 默认值	第一个查询
探索 IPInfo 结构体	熟悉 28 个字段	创建 Client
查询单个字段	GetField 省带宽	探索结构
查询自己的公网 IP	GetClientIPInfo	创建 Client

🛡 错误与校验

• 处理五种错误
• 识别保留地址
• 自定义错误处理

🔧 配置与认证

• 配置 API Key
• 两种认证方式对比
• 定制 HTTP 客户端
• 为请求加超时
• 加限流器
• 观察自动重试

🌐 数据与格式

• 获取 XML/CSV/YAML
• JSONP 跨域实战
• 解析经纬度并算距离
• 查询 IPv6 地址

🚀 实战集成

• 批量查询一百个 IP
• 写一个 GeoIP 中间件
• 按 IP 货币本地化
• 显示用户本地时间
• 按 ASN 过滤流量
• 生成 CSV 报表

🧪 测试

• 用 httptest 测试

🚀 下一步

🗺 学完教程后去哪？

教程带你「能跑起来」，指南带你「理解为什么」，Cookbook 给你「可直接粘贴的方案」，最佳实践帮你「上生产」。

去向	适合谁	你将获得
📖 指南	想理解原理	概念深度讲解
🍳 Cookbook	想要现成方案	可粘贴的完整食谱
✅ 最佳实践	准备上生产	生产级 checklist