IPython执行Python脚本时sklearn别名导入报AttributeError但交互式环境正常

1. 最基础的Python包导入规则 #

Python默认不会在导入主包时自动加载其下的所有子模块，只有两种情况子模块会变成主包的可访问属性：

• 主包自身的__init__.py文件里显式写了导入该子模块的逻辑
• 你主动执行过import sklearn.datasets这类明确的子模块导入语句

如果没有上述动作，直接访问sklearn.datasets就会触发AttributeError。
另外需要明确：import sklearn和import sklearn as sk本质没有任何区别——两者都是把sys.modules中已经加载的sklearn模块对象，分别赋值给变量sklearn和sk，两个变量指向完全相同的内存对象，属性自然完全一致。

2. 各场景表现差异的根源 #

为什么交互式环境下两种写法都能跑？ #

IPython的交互式会话默认启用了子模块懒导入钩子：当你访问某个模块不存在的属性时，IPython会自动判断这个属性是不是对应子模块，然后隐式执行导入逻辑。
比如你在交互式会话里敲sk.datasets.load_iris()，IPython检测到sk（也就是sklearn）没有datasets属性，会自动帮你执行import sklearn.datasets，导入完成后再访问属性就成功了。但这个功能只在交互式会话生效，用ipython <脚本文件>执行脚本时，会退化为标准Python的导入逻辑，不会触发自动导入。

为什么无别名的脚本写法能正常运行？ #

这说明你运行该脚本的环境里，已经有其他隐式导入动作把sklearn.datasets挂载到了主包上，比如：

• IPython的启动预加载配置（ipython_config.py）里预先写了import sklearn.datasets
• 其他被你导入的依赖库，内部已经导入过sklearn.datasets
• 你使用的sklearn版本较新，主包__init__.py已经显式导入了datasets这类常用子模块

为什么别名的脚本写法会报错？ #

报错本质就是运行该脚本的环境里，没有任何地方显式导入过sklearn.datasets，主包对象上没有这个属性。你之前测试无别名版本能运行，大概率是之前的脚本残留了隐式导入逻辑（比如没注意到脚本里曾经写过import sklearn.datasets，或者预加载配置只在交互式会话生效、执行脚本时没加载）。

3. 为什么Scipy的别名导入写法完全正常？ #

这是包自身设计的差异：Scipy的主包__init__.py从一开始就设计为显式导入所有常用子模块（包括special、linalg等），只要你执行import scipy，这些子模块就会自动挂载到主包对象上，不需要额外的隐式导入或IPython的懒导入钩子，自然不管用不用别名都能正常运行。

解决方法 #

不管用不用别名，只要显式导入需要的子模块即可，不需要依赖环境的隐式预加载：

# 写法1：直接导入需要的子模块，用的时候直接调用
import sklearn.datasets
iris = sklearn.datasets.load_iris()

# 写法2：用别名也可以，只要额外显式导入子模块即可
import sklearn as sk
import sklearn.datasets  # 这句话会把datasets挂载到sk的属性上
iris = sk.datasets.load_iris()

# 写法3：直接给子模块起别名，最简洁
import sklearn.datasets as sk_datasets
iris = sk_datasets.load_iris()

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