默认情况下，python-telegram-bot 的 `replykeyboardmarkup` 将按钮按行（row）组织；要让每个按钮独占一行（垂直堆叠），需将每个按钮置于独立的子列表中；反之，若想水平并排显示多个按钮，则应将它们放在同一子列表内。
在使用 python-telegram-bot 构建 ConversationHandler 类型的交互式机器人时，ReplyKeyboardMarkup 是控制用户输入界面的关键组件。其布局逻辑非常明确：外层列表代表键盘的“行”（rows），每个内层列表代表“一行中的按钮”（buttons in that row）。
✅ 正确理解结构：
# 水平排列（1 行 × 3 列）→ 所有按钮在同一行 reply_keyboard = [["Boy", "Girl", "Other"]] # 垂直排列（3 行 × 1 列）→ 每个按钮独占一行 reply_keyboard = [["Boy"], ["Girl"], ["Other"]] # 混合布局（2 行：第1行2个，第2行1个） reply_keyboard = [["Yes", "No"], ["Maybe"]]
? 使用示例（整合进 ConversationHandler）：
from telegram import ReplyKeyboardMarkup, Update
from telegram.ext import Application, CommandHandler, ContextTypes, ConversationHandler, MessageHandler, filters
GENDER = range(1)
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> int:
# 垂直按钮：每项单独成行
reply_keyboard = [["Male"], ["Female"], ["Non-binary"], ["Prefer not to say"]]
await update.message.reply_text(
"Please select your gender:",
reply_markup=ReplyKeyboardMarkup(
reply_keyboard,
one_time_keyboard=True, # 选择后自动收起键盘
resize_keyboard=True, # 适配手机屏幕尺寸
input_field_placeholder="Tap one option below"
)
)
return GENDER
# 后续 handler 略...⚠️ 注意事项：
立即学习“Python免费学习笔记（深入）”；
- ReplyKeyboardMarkup 不支持跨行合并或复杂网格（如 CSS Grid），所有布局必须通过嵌套列表显式定义；
- 若按钮文本过长，Telegram 客户端可能自动换行或截断——建议控制文字长度（推荐 ≤ 20 字符）；
- 在 ConversationHandler 中，确保每次发送带键盘的消息都使用 reply_markup 参数，且状态流转逻辑与按钮内容匹配；
- 测试时务必在真实 Telegram 客户端中验证效果（Web 版/桌面版/移动端表现一致）。
? 提示：如需更灵活的内联按钮（不依赖用户输入焦点、支持回调、可跨消息复用），请改用 InlineKeyboardMarkup —— 它的结构规则相同（[[button1, button2], [button3]]），但行为和适用场景完全不同。
