如何在 Python Telegram Bot 中实现水平排列的自定义键盘按钮

默认情况下，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 略...

⚠️ 注意事项：

• ReplyKeyboardMarkup 不支持跨行合并或复杂网格（如 CSS Grid），所有布局必须通过嵌套列表显式定义；
• 若按钮文本过长，Telegram 客户端可能自动换行或截断——建议控制文字长度（推荐 ≤ 20 字符）；
• 在 ConversationHandler 中，确保每次发送带键盘的消息都使用 reply_markup 参数，且状态流转逻辑与按钮内容匹配；
• 测试时务必在真实 Telegram 客户端中验证效果（Web 版/桌面版/移动端表现一致）。

? 提示：如需更灵活的内联按钮（不依赖用户输入焦点、支持回调、可跨消息复用），请改用 InlineKeyboardMarkup —— 它的结构规则相同（[[button1, button2], [button3]]），但行为和适用场景完全不同。