如何使用PyTelegramBotAPI（telebot）实现分页按钮？

首先确保你已安装PyTelegramBotAPI：

pip install pytelegrambotapi

核心实现思路 #

分页功能依赖InlineKeyboard的回调机制，通过回调数据传递当前页码，维护分页状态后动态生成对应页码的内容和按钮组。

完整代码示例 #

import telebot
from telebot.types import InlineKeyboardMarkup, InlineKeyboardButton

# 替换为你的机器人Token
BOT_TOKEN = "你的Bot Token"
bot = telebot.TeleBot(BOT_TOKEN)

# 模拟分页数据（可替换为实际业务数据）
data_list = ["项目1", "项目2", "项目3", "项目4", "项目5", "项目6", "项目7", "项目8", "项目9", "项目10"]
ITEMS_PER_PAGE = 2  # 每页展示条目数

def generate_pagination_keyboard(current_page, total_pages):
    """生成分页控制键盘"""
    keyboard = InlineKeyboardMarkup()
    buttons = []
    
    # 上一页按钮
    if current_page > 1:
        buttons.append(InlineKeyboardButton("⬅️ 上一页", callback_data=f"page_{current_page-1}"))
    
    # 页码指示器
    buttons.append(InlineKeyboardButton(f"{current_page}/{total_pages}", callback_data="page_info"))
    
    # 下一页按钮
    if current_page < total_pages:
        buttons.append(InlineKeyboardButton("下一页 ➡️", callback_data=f"page_{current_page+1}"))
    
    keyboard.add(*buttons)
    return keyboard

def get_page_content(page_num):
    """生成指定页码的内容文本"""
    start_idx = (page_num - 1) * ITEMS_PER_PAGE
    end_idx = start_idx + ITEMS_PER_PAGE
    page_items = data_list[start_idx:end_idx]
    
    content = f"第 {page_num} 页内容:\n"
    for idx, item in enumerate(page_items, start=start_idx+1):
        content += f"{idx}. {item}\n"
    return content

@bot.message_handler(commands=['start'])
def init_pagination(message):
    total_pages = (len(data_list) + ITEMS_PER_PAGE - 1) // ITEMS_PER_PAGE  # 计算总页数
    first_page_content = get_page_content(1)
    keyboard = generate_pagination_keyboard(1, total_pages)
    bot.send_message(message.chat.id, first_page_content, reply_markup=keyboard)

@bot.callback_query_handler(func=lambda call: call.data.startswith('page_'))
def handle_pagination_callback(call):
    try:
        page_num = int(call.data.split('_')[1])
        total_pages = (len(data_list) + ITEMS_PER_PAGE - 1) // ITEMS_PER_PAGE
        
        if page_num < 1 or page_num > total_pages:
            bot.answer_callback_query(call.id, "无效页码")
            return
        
        new_content = get_page_content(page_num)
        new_keyboard = generate_pagination_keyboard(page_num, total_pages)
        
        # 更新消息内容与键盘
        bot.edit_message_text(chat_id=call.message.chat.id, message_id=call.message.message_id, text=new_content, reply_markup=new_keyboard)
        bot.answer_callback_query(call.id)
    except Exception:
        bot.answer_callback_query(call.id, "处理出错")

if __name__ == '__main__':
    bot.infinity_polling()

关键细节说明 #

• 分页数据切片：get_page_content通过计算起始/结束索引，从总数据中截取当前页的内容。
• 键盘动态生成：generate_pagination_keyboard根据当前页码和总页数，决定是否显示上/下一页按钮，回调数据用page_页码格式区分操作。
• 回调逻辑处理：捕获分页按钮的回调请求后，解析页码并更新消息的文本和键盘，实现无刷新分页效果。
• 总页数计算：用(总数据量 + 每页条目数 - 1) // 每页条目数的方式避免浮点数，确保总页数计算准确。

扩展方向 #

• 多用户场景下，不要用全局变量存储状态，建议用字典（key为用户ID）或数据库维护每个用户的当前页码。
• 可添加「首页」「末页」按钮，进一步优化操作体验。
• 实际项目中，data_list可替换为从数据库、外部API获取的动态数据。

内容的提问来源于stack exchange，提问作者Muhammad Rizo Muxtorov