Python模块引用报错：执行check.py时找不到hva模块

问题原因 #

单独运行ansatz.py时，Python会自动将该文件所在的src/quantum/目录加入模块搜索路径（sys.path），所以能直接找到同级的hva目录；但运行check.py时，模块搜索路径是src/，Python会在src/下找hva模块，而hva实际在src/quantum/下，因此抛出ModuleNotFoundError。

具体解决方法 #

方法1：使用相对导入（推荐） #

修改ansatz.py中的导入语句为相对路径，明确从当前目录（quantum/）导入hva模块：

# ansatz.py
from .hva.single_layer_hva import SingleLayerHVA

single_layer_hva = SingleLayerHVA()

如果需要保留原有别名写法，也可以这样写：

# ansatz.py
from .hva import single_layer_hva as hva

single_layer_hva = hva.SingleLayerHVA()

相对导入中的.代表当前模块所在的目录，这样无论从哪个入口导入quantum.ansatz，都能正确找到hva子模块。

方法2：使用绝对导入 #

基于项目的包结构，用完整的包路径导入hva模块，修改ansatz.py：

# ansatz.py
from quantum.hva.single_layer_hva import SingleLayerHVA

single_layer_hva = SingleLayerHVA()

这种写法需要确保src/目录在模块搜索路径中（运行check.py时默认满足，因为check.py在src/下）。

方法3：手动添加模块路径（不推荐，耦合性高） #

如果不想修改导入语句，可以在check.py开头添加代码，将quantum/目录加入模块搜索路径：

# check.py
import sys
import os
sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), 'quantum'))

import quantum.ansatz as a
a.get_ansatz('sample_ansatz')

但这种方法会增加代码耦合，不建议在正式项目中使用。

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