调用自定义phase_2模块时报‘pd未定义’错误的排查与解决

报错逻辑拆解 #

• 类作用域的导入不会进入模块全局命名空间
  当把所有依赖导入写在phase_2类的定义块内部时，导入生成的pd、np、dt等变量，不会成为当前模块的全局变量，只会作为类的类属性挂载在phase_2.__dict__中，仅支持通过phase_2.pd这类显式访问类属性的方式调用。
• 类内部函数的变量查找路径不会回溯类命名空间
  类中定义的today()函数，运行时的变量查找顺序严格遵循：函数局部作用域 → 定义该函数的模块全局作用域 → Python内置作用域，全程不会自动检索所属类的类作用域内的变量。
• 函数的全局作用域在定义阶段就已静态绑定
  哪怕在测试调用脚本中显式导入了pandas，由于today()函数是在phase_2模块中定义的，它的全局作用域仅指向phase_2模块本身，完全不会读取测试脚本的全局命名空间中的导入内容。

直观验证方式：在类定义完成后执行print(phase_2.pd)，可以正常返回pandas模块的引用，但直接在类的方法中调用pd.to_datetime()会因找不到变量抛错。

修正实现的运行原理 #

将所有依赖导入语句移到类定义外部之后，pd、dt等依赖的引用就成为了phase_2模块全局命名空间的正式成员。当today()函数运行时，按照查找顺序在局部作用域找不到目标变量，就会在模块全局作用域中定位到对应的导入别名，顺利完成日期格式转换逻辑。

相关开发注意事项 #

• 不要将模块级依赖导入写在类/函数定义内部：这种写法除了触发作用域查找报错，还会污染类的命名空间，增加外部代码意外篡改内部依赖引用的风险
• 跨模块调用时，不要依赖调用方的导入逻辑：被调用函数需要的所有依赖，必须在自身定义的模块作用域内完成导入，不能假设调用方已经完成了对应依赖的导入

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