telebot开发中如何全局使用函数内定义的text变量？

问题描述 #

使用telebot库开发Telegram机器人时，尝试在全局作用域使用hello函数内部定义的text变量始终失败。
运行后报错：NameError: name 'text' is not defined
已尝试在函数内使用global关键字声明变量，仍未生效，需要实现全局使用该变量的需求。

问题代码 #

@bot.message_handler(content_types=['text'])
def welcome(message):
    bot.send_message(message.chat.id,"Hello, <b>{0.first_name}</b>!".format(message.from_user, bot.get_me()), parse_mode='html')
    sent = bot.send_message(message.chat.id,"Enter your name".format(message.from_user, bot.get_me()), parse_mode='html')
    bot.register_next_step_handler(sent, hello)

def hello(message):
    text = message.text
    print(text)
print(text)


bot.polling(none_stop=True, timeout=123)

报错原因 #

• 代码执行顺序冲突。Python逐行从上到下加载执行代码，写在全局的print(text)会在程序启动初始化阶段就运行——此时机器人还没启动轮询，用户根本未发送消息，hello函数完全没有被触发过，对应存储的text变量还未被创建，自然无法被读取。
• global声明逻辑不完整。如果要在hello函数内通过global把变量绑定到全局命名空间，需要先在全局作用域提前初始化该变量；否则在函数执行前的全局加载阶段，这个变量依然不存在。同时因为之前全局print的执行时机远早于hello函数被触发的时间，哪怕写了global也无法解决时序问题。

解决步骤 #

• 在全局作用域提前初始化需要全局使用的变量，避免未定义错误
• 在hello函数内部用global关键字声明对应变量，把用户输入的内容赋值给该全局变量
• 移除全局顶层直接执行的print(text)语句，所有需要用到该变量的业务逻辑，要放到text被成功赋值后才会执行的代码段里（比如hello函数内部、后续触发的回调逻辑中）

调整后的可运行代码 #

# 全局提前初始化变量
user_input_text = None

@bot.message_handler(content_types=['text'])
def welcome(message):
    bot.send_message(message.chat.id,"Hello, <b>{0.first_name}</b>!".format(message.from_user, bot.get_me()), parse_mode='html')
    sent = bot.send_message(message.chat.id,"Enter your name".format(message.from_user, bot.get_me()), parse_mode='html')
    bot.register_next_step_handler(sent, hello)

def hello(message):
    global user_input_text
    # 将用户输入赋值给全局变量
    user_input_text = message.text
    # 所有依赖该变量的逻辑放到此处执行
    print(user_input_text)


bot.polling(none_stop=True, timeout=123)

补充提示：如果机器人需要同时服务多个用户，单个全局变量存储用户输入会出现不同用户数据互相覆盖的问题，这种场景更适合用字典按用户ID维度存储对应数据。

内容的提问来源于stack exchange，提问作者elbek rustamov