优先选gotwi；因go-twitter仅支持v1.1和OAuth 1.0a，而gotwi专为v2设计，支持Bearer Token和OAuth 2.0，具备权限粒度控制、新字段支持及合规认证机制。
用 go-twitter 还是 gotwi？先看你的认证方式和 API 版本
Twitter（现 X）API 分 v1.1 和 v2 两个主版本，它们的认证机制、权限范围和返回结构完全不同。go-twitter 只支持 OAuth 1.0a（用户上下文），只能调用 v1.1；gotwi 则专为 v2 设计，支持 Bearer Token（只读）和 OAuth 2.0（读写），且默认启用更严格的权限粒度控制。
- 如果你已有
Consumer Key+Access Token这类四元组凭证，且只需发推、查 timeline，go-twitter仍可用，但注意它不支持 v2 的新字段（如 public metrics、context annotations） - 如果你用的是开发者门户新生成的
Bearer Token或Client ID/Secret，必须选gotwi——go-twitter根本无法解析 v2 的 JSON 响应格式，会直接 panic 或返回空数据 - OAuth 2.0 的
scope必须显式勾选tweets.write才能发推，仅靠read权限调用client.Tweets.Create会返回403 Forbidden
go-twitter 发推失败的三个高频原因
即使凭证正确，client.Statuses.Update 也常静默失败或报错，根本不在网络层，而在参数校验和平台策略上。
-
text超过 280 字符不会截断，而是直接返回403错误，且错误信息里不提示长度问题，需手动utf8.RuneCountInString(text) 校验 - 带图片时，必须先调用
Media.Upload获取media_id，再传给StatusUpdateParams.MediaIds；若直接传本地路径或 URL，会返回media_ids is invalid - 使用
Lat/Long参数需提前在开发者后台开启“位置权限”，否则字段被忽略，且无任何警告
gotwi 初始化 client 时别硬编码 token
gotwi.NewClientWithBearerToken 看似简单，但生产环境一旦把 token 写死在代码里，就等于把钥匙贴在门上。X 平台对泄露 token 的应用会立即封禁，且不可恢复。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 务必从环境变量读取：
os.Getenv("TWITTER_BEARER_TOKEN")，并在部署时通过 CI/CD 注入，禁止提交到 Git - 如果要用 OAuth 2.0 客户端凭证流，
gotwi.NewClientWithClientCredentials需要额外传ClientID和ClientSecret，这两项同样不能硬编码 - 测试时可借助
godotenv.Load(".env.local")加载本地配置，但.env.local必须加入.gitignore，且确保 IDE 不自动同步该文件
搜索推文时 query 语法不兼容旧版高级搜索
X 平台 v2 的 GET /2/tweets/search/recent 接口只接受官方定义的 搜索运算符，和网页端“高级搜索”界面生成的语句不完全等价。
立即学习“go语言免费学习笔记（深入）”；
-
lang:zh有效，但lang:cn无效；is:retweet可用，filter:retweets是 v1.1 语法，v2 会返回400 Bad Request - 时间范围必须用
start_time/end_time参数传 ISO 8601 字符串（如"2026-03-20T00:00:00Z"），不能在 query 里写since:2026-03-20 - 关键词含空格或特殊符号（如
#AI、"hello world"）必须 URL 编码，否则gotwi默认不处理，请求直接失败
最稳妥的做法是先在 官方 Query Builder 里试出合法 query，再复制进代码，别凭经验手写。
