Python 动态导入模块：利用字符串路径加载类的原理与实践

Felix

发布时间：2026-10-13 | 4人浏览过

原创

本文详解Python中通过字符串动态导入模块的方法。以Scrapy源码为例，解析如何利用importlib.import_module结合getattr函数，根据完整路径字符串加载指定类。文章提供从路径分割、模块导入到属性获取的完整步骤，并附带测试代码验证其有效性，适用于需要动态加载组件的场景。

Python动态导入模块的基本概念

在Python开发中，常规导入第三方模块通常直接使用 import 关键字。


import scrapy
from scrapy.spider import Spider

Scrapy中的字符串配置示例

然而，若查阅 Scrapy 框架的 settings.py 配置文件，会发现其中通过字符串形式来指定 pipeline 和 middleware 的配置方式。


DOWNLOADER_MIDDLEWARES = {
   'Test.middlewares.ExceptionRetryMiddleware': 545,
   'Test.middlewares.BOProxyMiddlewareV2': 543,
 }
 
 SPIDER_MIDDLEWARES = {
  'Test.middlewares.LoggingRequestMiddleware': 543,
 }

例如，配置项 Test.middlewares.ExceptionRetryMiddleware 实际上指向根目录下 Test 文件夹中 middlewares.py 文件内的 ExceptionRetryMiddleware 类。那么，Scrapy 框架是如何依据该字符串路径成功导入对应类的呢？

通过查阅 Scrapy 的源代码，可以找到实现该功能的逻辑代码。

源码解析：importlib与getattr的配合使用


def load_object(path):
  """Load an object given its absolute object path, and return it.
  object can be a class, function, variable or an instance.
  path ie: 'scrapy.downloadermiddlewares.redirect.RedirectMiddleware'
  """
  try:
    dot = path.rindex('.')
  except ValueError:
    raise ValueError("Error loading object '%s': not a full path" % path)
  module, name = path[:dot], path[dot+1:]
  mod = import_module(module)
  try:
    obj = getattr(mod, name)
  except AttributeError:
    raise NameError("Module '%s' doesn't define any object named '%s'" % (module, name))
  return obj

核心实现依赖于 importlib 模块提供的 import_module 函数。

具体处理流程首先是将字符串路径依据最右侧的 '.' 分割为两部分。例如，将 'Test.middlewares.LoggingRequestMiddleware' 拆分为模块路径 'Test.middlewares' 和类名 'LoggingRequestMiddleware'。

接着，调用 import_module 函数导入左侧指定的模块部分。

最后，利用 getattr 函数从上一步获取的模块对象中提取出具体的类。