scipy报has no attribute signal属性错误的原因

两个Python文件的代码如下：

• file1.py

# 注释掉下一行则运行报错，取消注释则报错消失
# import scipy.signal
import file2

file2.foo()

• file2.py

import scipy

def foo():
    scipy.signal.butter(2, 0.01, 'lowpass', analog=False)

直接运行file1.py时抛出的报错：

File "file2.py", line 5, in foo
scipy.signal.butter(2, 0.01, 'lowpass', analog=False)
AttributeError: module 'scipy' has no attribute 'signal'

这个问题完全是Python包导入的默认规则导致的，没有特殊逻辑：

1. 顶层包导入不会自动加载子模块
   scipy是包含大量子模块的命名空间包，不是单个py文件。当你写import scipy时，Python只会加载最外层的scipy包对象到当前作用域，不会递归加载它下面的signal、linalg等所有子模块。这时候访问scipy.signal本质是在scipy包对象上查找名为signal的属性，子模块没加载自然不存在这个属性，就会抛出AttributeError。
2. 全局模块缓存的副作用
   Python运行过程中，所有加载过的模块都会存入sys.modules字典做全局单例缓存，不会因为在不同文件中执行import就重复加载同一个模块。
   当取消file1.py中import scipy.signal的注释后，代码执行顺序带来了额外影响：
   • 首先执行import scipy.signal：Python先加载顶层scipy包存入缓存，再加载scipy.signal子模块存入缓存，同时自动将signal子模块绑定为scipy包对象的属性
   • 之后执行import file2：file2中的import scipy检测到scipy已经存在于缓存中，直接获取已经存在的scipy对象引用使用——此时这个scipy对象已经绑定了signal属性，后续调用scipy.signal.butter()自然不会报错。

靠其他文件提前导入子模块来让代码正常运行属于典型的隐式依赖，对导入顺序极度敏感：后续只要调整file1的导入顺序、删掉那行看起来和file2无关的scipy导入，代码就会直接崩溃，问题隐蔽很难排查。
只要在用到对应子模块的文件中显式导入依赖即可，两种常用写法都可以：

# 写法1：显式导入需要的子模块
import scipy.signal

def foo():
    scipy.signal.butter(2, 0.01, 'lowpass', analog=False)

# 写法2：直接导入需要调用的函数
from scipy.signal import butter

def foo():
    butter(2, 0.01, 'lowpass', analog=False)

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