Python跨模块导入实例触发NameError，已尝试多种方法仍未解决

嘿，我来帮你捋捋这个问题！你遇到的NameError大概率是这几个常见坑导致的，咱们一个个排查：

首先，先确认最基础的几个点 #

• 文件位置与命名：确保cars.py和cars2.py在同一个文件夹里，而且文件名没有拼写错误（比如别把cars2写成car2），也别和Python内置模块重名（比如别叫sys.py这种）。
• 实例的定义位置：你要导入的实例必须是在cars2.py的顶层作用域定义的！举个反例：如果你的实例是在cars2.py的某个函数或者类里面定义的，那外部根本访问不到，比如：

  # 错误示例：实例在函数内部，导入后拿不到
  def create_car():
      my_car = Car()  # 这个实例只在函数内部有效
  

  正确的写法应该是把实例直接写在模块最外层：

  # cars2.py 正确写法
  class Car:
      pass
  
  my_car = Car()  # 顶层定义，能被外部导入
  

然后排查导入相关的问题 #

1. 循环导入陷阱 #

如果你的cars2.py也导入了cars.py里的内容（比如from cars import CarOwner），那会触发循环导入，导致模块加载不完整，这时候就会出现明明导入了却找不到名字的情况。

解决办法：

• 把两个模块共享的代码（比如Car类）抽出来放到第三个模块，比如car_core.py，然后cars.py和cars2.py都从这个模块导入。
• 或者用延迟导入：把导入语句放到需要使用的方法内部，而不是模块顶部，比如：

  # cars.py 里的类方法
  class CarOwner:
      def drive(self):
          from cars2 import my_car  # 用到的时候再导入
          my_car.start()
  

2. 导入语句的位置与写法 #

别把导入语句藏在类定义的奇怪位置，最稳妥的是把导入放在cars.py的最顶部，比如：

# cars.py 顶部导入
from cars2 import my_car

class CarOwner:
    def use_car(self):
        print(my_car)  # 这里直接用就行

如果你用from cars2 import *，要确保cars2.py里的实例没有被__all__限制（如果cars2.py里定义了__all__ = ['some_other_item']，那*只会导入列表里的内容）。

3. 模块路径问题 #

如果两个文件不在同一个目录，或者当前工作目录不是文件所在的目录，Python会找不到cars2模块。这时候可以把文件所在目录加入Python的搜索路径：

# 在cars.py顶部添加
import sys
sys.path.append("/path/to/your/folder")  # 替换成你的文件夹路径

from cars2 import my_car

给你一个能跑通的示例 #

假设cars2.py内容：

# cars2.py
class ElectricCar:
    def __init__(self, brand):
        self.brand = brand

# 顶层定义实例
my_tesla = ElectricCar("Tesla Model 3")

cars.py内容：

# cars.py
from cars2 import my_tesla

class Garage:
    def display_car(self):
        print(f"我的车库里有一台：{my_tesla.brand}")

# 测试运行
if __name__ == "__main__":
    my_garage = Garage()
    my_garage.display_car()  # 会输出：我的车库里有一台：Tesla Model 3

你照着这个结构改改，应该就能解决问题啦！

内容的提问来源于stack exchange，提问作者Andrew V.