导入pandas后函数内无法访问pd变量的异常问题咨询

这个错误的核心原因是你的main函数内部存在对pd变量的赋值操作（哪怕该赋值语句在print(pd)之后）。Python的作用域规则会在编译阶段就将pd标记为函数的局部变量，导致在赋值前引用它时触发UnboundLocalError。

错误示例 #

你的代码大概率是类似这种结构：

import pandas as pd

def main():
    print(pd)  # 触发UnboundLocalError
    pd = "some_value"  # 此处赋值让Python将pd判定为局部变量

if __name__ == "__main__":
    main()

解决方案 #

根据你的需求选择对应方式：

• 如果需要保留函数内的pd赋值：在函数开头用global关键字声明pd为全局变量，这样Python会优先使用全局作用域的pd模块，同时允许你后续修改它：

import pandas as pd

def main():
    global pd
    print(pd)  # 正常输出pandas模块对象
    pd = "some_value"

if __name__ == "__main__":
    main()

• 如果是误写了pd的赋值：直接删除或修改那行错误的赋值代码，函数会自动使用全局作用域中导入的pd模块，无需额外声明。

关于PyCharm调试的疑问解释 #

PyCharm调试控制台是在混合作用域中查看变量，它会同时展示全局和当前局部作用域的内容，所以你能看到全局的pd模块。但Python解释器执行代码时是严格遵循作用域规则的，编译阶段就已经标记pd为局部变量，运行时不管赋值语句在引用之后还是之前，都会触发错误。

内容的提问来源于stack exchange，提问作者Johannes Kreckel