PyCharm中reload自定义模块报错NameError: name 'xxx'未定义

一、修复NameError: name 'xxx' is not defined错误 #

出现这个错误的核心原因是你的模块xxx没有被导入到当前控制台的全局命名空间中。哪怕你之前通过from xxx import 某个函数导入了模块内的成员，但整个模块对象并未加载到命名空间里，导致reload()找不到对应的模块名。

解决方法：

• 先在控制台执行完整的模块导入：

  import xxx
  

• 再执行重载操作：

  from importlib import reload
  reload(xxx)
  

二、解决修改函数后调用结果未更新的问题 #

即便成功重载模块，你仍可能遇到调用旧函数结果的情况，原因如下：

• 若之前通过from xxx import your_function直接导入函数，这个导入的your_function变量仍指向旧版本的函数对象，重载模块不会自动更新该引用。
• 控制台中已创建的实例、保存的函数引用，都会保留旧的内存地址。

对应解决方案：

1. 重载模块后，重新导入需要使用的函数：

   from xxx import your_function  # 重新执行导入，覆盖旧引用
   

2. 或者直接通过模块名调用函数，避免直接引用：

   import xxx
   xxx.your_function()  # 每次调用都从模块对象取最新的函数
   

3. 额外提示：可以点击PyCharm控制台右上角的垃圾桶图标，重置控制台会话，重新导入模块并测试，彻底清除旧的上下文状态。

三、针对PyCharm 2022.3社区版的补充说明 #

• 确保自定义模块xxx所在目录被PyCharm识别为"源根"：右键目录 → 选择"Mark Directory as" → "Sources Root"，避免导入时出现路径问题。
• 若你是在运行脚本后打开的控制台，脚本结束后模块可能被清理，需要手动重新导入模块再执行重载。

内容的提问来源于stack exchange，提问作者Chris H.