Python变量qtd已定义却触发NameError，直接用值正常求助

问题场景 #

尝试定位工作表中特定值的位置，将目标值存入变量qtd后，执行列表推导式时触发NameError: name 'qtd' is not defined错误，但直接在推导式中使用具体数值就能正常返回结果[0]。

错误代码示例：

list = df['Quantidade de Cotas'].tolist()
qtd = 2136252.54442995
print(qtd)

# 此处触发NameError
res = [i for i,j in enumerate(list) if j == qtd]
print(res)

正常运行的代码示例（替换为具体数值）：

list = df['Quantidade de Cotas'].tolist()
qtd = 2136252.54442995
print(qtd)

res = [i for i,j in enumerate(list) if j == 2136252.54442995]
print(res)

问题原因 #

核心是变量作用域不匹配：

• 若在函数、类等局部作用域中定义了qtd，但列表推导式在全局作用域执行，会导致推导式无法访问局部变量qtd。
• 在Jupyter Notebook等交互式环境中，若单元格执行顺序混乱（比如先跑了推导式单元格，再跑qtd定义的单元格），也会出现变量未定义的错误。
• 额外提醒：list是Python内置类型，用它做变量名会覆盖内置函数，可能引发其他隐性问题。

解决方案 #

1. 保证作用域一致：
   如果qtd定义在局部作用域（比如函数内），将列表推导式也放在同一作用域中；脚本环境下，确保qtd的定义代码在推导式之前执行。
2. 修正交互式环境执行顺序：
   在Jupyter等工具中，按顺序重新执行qtd定义和推导式的单元格，确保变量被正确加载。
3. 替换内置类型变量名：
   把list改为qtd_list这类非内置名称，避免冲突。

修正后的完整代码 #

# 替换内置变量名list为qtd_list
qtd_list = df['Quantidade de Cotas'].tolist()
qtd = 2136252.54442995
print(qtd)

# 确保qtd在推导式之前定义，且同作用域
res = [i for i,j in enumerate(qtd_list) if j == qtd]
print(res)

内容的提问来源于stack exchange，提问作者Eduardo Santos Vieira