必须先用 BotFather 获取形如1234567890:AbCdeFgHiJkLmNoPqRsTuVwXyZ的token，初始化bot时设Debug:true，并调用GetMe验证连接；Webhook需HTTPS、有效证书、正确读取原始body，且SetWebhook前须DeleteWebhook。
怎么用 github.com/go-telegram-bot-api/telegram-bot-api/v5 发起第一条消息
不配 token 就发不出消息，这是最常卡住的起点。库本身不校验 token 格式，但 Telegram 服务端一拒收，bot.Send 就会返回 Bad Request: chat not found 或更模糊的 Unauthorized —— 实际八成是 token 写错了、多空格、混用了测试环境 token。
- 从 BotFather 拿到的 token 是形如
1234567890:AbCdeFgHiJkLmNoPqRsTuVwXyZ的字符串，直接赋值给变量，别加引号外的空格或换行 - 初始化 bot 时必须显式设置
Debug: true才能看到底层 HTTP 请求和响应，否则出错只能靠猜 - 发消息前先用
GetMe确认连接通不通：me, err := bot.GetMe() if err != nil { log.Fatal(err) // 这里崩了，基本就是 token 或网络问题 } log.Printf("Bot username: %s", me.UserName)
Webhook 配置失败的三个高频原因
调用 SetWebhook 成功不代表 Webhook 就跑起来了。Telegram 会立刻向你填的 URL 发 POST /，如果没响应 200，它就静默放弃，后续消息全丢。
- URL 必须是 HTTPS，且证书有效（Let’s Encrypt 可以，自签证书不行）；本地开发别硬上 webhook，用
GetUpdates轮询更省事 - 你的 HTTP handler 必须读取原始 body（不能被中间件提前解析成 JSON），否则 Telegram 的签名验证会失败；用
r.Body直读，别碰r.FormValue或json.NewDecoder(r.Body)两次 -
SetWebhook的AllowedUpdates字段如果设为空 slice（[]string{}），Telegram 默认只推message类型，漏掉callback_query或inline_query—— 要全收就传nil，别传空数组
Update 结构体里哪些字段真正该检查
Telegram 的 Update 是个大 union，字段嵌套深、可选多。盲目解包容易 panic，比如访问 update.Message.Text 前没确认 update.Message 非 nil，或者以为所有消息都有 Text（其实语音、贴纸、位置消息就没有）。
- 永远先判空：
if update.Message != nil && update.Message.Text != ""，而不是直接update.Message.Text == "/start" - 回调查询走的是
update.CallbackQuery，不是Message；内联查询走update.InlineQuery；这些字段互斥，不会同时存在 - 用户 ID 在不同场景下位置不同：普通消息在
update.Message.From.ID，回调里在update.CallbackQuery.From.ID，别统一硬写一个路径
为什么本地调试时 GetUpdates 突然不返回新消息
不是代码坏了，是 Telegram 的 offset 机制在起作用。每次调用 GetUpdates 后，必须把返回的最后一条 Update.ID + 1 当作下次请求的 Offset，否则 Telegram 认为你没处理完，不再推送新消息。
立即学习“go语言免费学习笔记（深入）”；
- 别手动写死
Offset: 0反复刷；正确做法是维护一个全局lastUpdateID int，每次循环后更新：if len(updates) > 0 { lastUpdateID = updates[len(updates)-1].UpdateID + 1 } -
GetUpdates默认超时 0 秒（即立即返回），想减少轮询压力，应设Timeout: 30（单位秒），配合长轮询 - 上线后切 webhook 前，务必先
DeleteWebhook，否则GetUpdates会一直返回空 —— Telegram 不允许两种模式共存
Webhook 的 URL 路径、TLS 证书、body 读取方式这三处，任何一个出问题，消息就彻底静音，而且 Telegram 不报错也不重试，得自己盯日志。别信“配置完就自动好”，每一步都得亲手验证响应码和 body 内容。
