Telegram InlineKeyboardButton不显示求助：复制Echo示例代码无效（v13.4.0）

我来帮你排查这个Inline键盘不显示的问题，结合你使用的Telegram.Bot v13.4.0和复制Echo示例代码的场景，下面是几个常见原因和对应的解决办法：

• 确认键盘类型是否正确
  最容易踩坑的点是把InlineKeyboardMarkup和ReplyKeyboardMarkup搞混。前者是和消息绑定的行内按钮，后者是底部的普通回复键盘。在v13.4.0中，正确构建Inline键盘的代码应该是这样的：

  var inlineKeyboard = new InlineKeyboardMarkup(new[]
  {
      new[]
      {
          InlineKeyboardButton.WithCallbackData("点击触发回调", "callback_1"),
          InlineKeyboardButton.WithUrl("打开外部链接", "https://example.com")
      }
  });
  

  如果你不小心用了ReplyKeyboardMarkup，那肯定看不到行内按钮。

• 发送消息时必须传入键盘参数
  调用SendTextMessageAsync时，一定要把构建好的InlineKeyboardMarkup对象传给replyMarkup参数，不能留空或者传错对象。示例代码如下：

  await botClient.SendTextMessageAsync(
      chatId: update.Message.Chat.Id,
      text: "这是一条带Inline按钮的消息",
      replyMarkup: inlineKeyboard
  );
  

  如果你是在Echo示例基础上修改的，要确认自己没有漏掉这个参数的传递。

• 检查异步调用是否正确等待
  如果你在同步方法里调用异步的发送消息方法，一定要确保正确等待异步操作完成。比如：

  // 错误写法：未等待异步操作，可能导致键盘未附加成功
  botClient.SendTextMessageAsync(...);
  // 正确写法：使用await等待
  await botClient.SendTextMessageAsync(...);
  // 或者在同步方法里用Wait()（不推荐，但临时测试可用）
  botClient.SendTextMessageAsync(...).Wait();
  

  未正确等待的话，可能会导致消息发送了，但键盘没有被正确附加。

• 测试最小化可复现代码
  排除原有代码中其他逻辑的干扰，写一个最简化的测试代码来验证：

  using Telegram.Bot;
  using Telegram.Bot.Types.ReplyMarkups;
  
  var botToken = "你的机器人Token";
  var testChatId = 123456789; // 替换成你的测试聊天ID
  
  var botClient = new TelegramBotClient(botToken);
  var inlineKeyboard = new InlineKeyboardMarkup(new[]
  {
      new[] { InlineKeyboardButton.WithCallbackData("测试按钮", "test_callback") }
  });
  
  await botClient.SendTextMessageAsync(testChatId, "测试Inline键盘", replyMarkup: inlineKeyboard);
  

  如果这段代码能正常显示按钮，说明你原来的代码里有其他逻辑影响了键盘的发送，比如消息过滤、权限限制等。

• 确认机器人权限和聊天状态
  确保你的机器人已经被用户启动（用户给机器人发过至少一条消息），如果是在群组里测试，要确认机器人有发送消息和附加键盘的权限。另外v13.4.0对应的Bot API版本是5.2，这个版本对Inline键盘的支持是没问题的，不用太担心版本兼容性。

内容的提问来源于stack exchange，提问作者Pooria.Shariatzadeh