刘心向学（31）：Python 中的__import__()函数

摘要：在 Python 编程中，我们通常使用import语句来导入模块。但你是否了解其背后的实现机制？Python 提供了一个内置函数__import__，它是import语句在底层调用的实际函数，用于动态导入模块。虽然大多数情况下推荐使用标准的import语法，但

分享兴趣，传播快乐，

增长见闻，留下美好！

亲爱的您，这里是LearningYard新学苑。

今天小编为大家带来文章 “刘心向学（31）：Python 中的__import__函数：动态导入模块的底层机制解析”

欢迎您的访问。

Share interest, spread happiness,

Increase knowledge, leave a beautiful!

Dear, this is LearningYard Academy.

Today, the editor brings you an article. “Liu Xinxiangxue (31): The __import__ Function in Python — A Deep Dive into the Low-Level Mechanism of Dynamic Module importLiu ”

Welcome to your visit.

一、思维导图（Mind Map）

二、引言（Introduction）

在 Python 编程中，我们通常使用import语句来导入模块。但你是否了解其背后的实现机制？Python 提供了一个内置函数__import__，它是import语句在底层调用的实际函数，用于动态导入模块。虽然大多数情况下推荐使用标准的import语法，但在某些高级场景（如插件系统、模块反射、动态加载等）中，理解并使用__import__ 可以带来更大的灵活性和控制力。

In Python programming, we usually use the import statement to import modules. But do you understand the underlying implementation mechanism? Python provides a built-in function __import__, which is the actual function called by the import statement at the lower level to dynamically import modules. Although the standard import syntax is recommended in most cases, understanding and using __import__ can bring greater flexibility and control in some advanced scenarios (such as plugin systems, module reflection, dynamic loading, etc.).

三、什么是__import__？（What is __import__?）

__import__是 Python 解释器用来实现模块导入机制的核心函数。当你写：

__import__ is the core function used by the Python interpreter to implement the module import mechanism. When you write:

或者：

or:

这些语句在底层都会被转换为对__import__的调用。

These statements are all converted into calls to __import__ at the lower level.

Its Basic syntax is as follows:

name：要导入的模块名（字符串形式）。

name: The name of the module to be imported (in string form).

globals/locals：通常传入全局和局部命名空间字典，一般使用默认值即可。

globals/locals: Usually pass the global and local namespace dictionaries; default values are generally used.

fromlist：指定从模块中导入的子模块或对象列表。

fromlist: Specifies the list of submodules or objects to import from the module.

level：相对导入的层级，默认为 0（绝对导入）。

level: The level of relative imports, defaulting to 0 (absolute import).

四、基本使用示例（Basic Usage Examples）

示例1：导入整个模块

Example 1: Importing an entire module

示例2：导入包中的子模块

Example 2: Importing submodules from a package

五、与importlib.import_module的对比（Comparison with importlib.import_module）

虽然__import__强大，但它语法复杂、容易出错，特别是处理相对导入时不够直观。因此，在现代 Python 开发中，更推荐使用importlib模块中的import_module函数。

Although __import__ is powerful, its syntax is complex and error-prone, especially when handling relative imports, which are not intuitive. Therefore, in modern Python development, it is more recommended to use the import_module function in the importlib module.

六、典型应用场景（Typical Use Cases）

1. 插件系统 / 动态加载模块（Plugin system / Dynamic module loading）

当模块名由配置文件、用户输入或运行时决定时，使用__import__或 import_module是理想选择：

When the module name is determined by a configuration file, user input, or runtime, using __import__ or import_module is an ideal choice:

2. 实现框架级别的自动注册机制（Implementing framework-level auto-registration mechanisms）

许多 Web 框架通过扫描模块并自动注册路由或组件，此时需要动态导入模块进行初始化。

Many web frameworks scan modules and automatically register routes or components, requiring dynamic module imports for initialization.

3. 模块反射与元编程（Module reflection and metaprogramming）

在需要根据字符串名称动态操作模块内容的场景下__import__提供了基础能力支持。

In scenarios where dynamic operations on module contents are required based on string names, __import__ provides fundamental capability support.

七、结语（Conclusion）

尽管我们在日常开发中很少直接使用__import__，但理解它有助于深入掌握 Python 的模块导入机制。对于需要动态加载模块、构建插件系统或实现框架级功能的开发者来说，它是不可或缺的知识点之一。当然，在多数情况下，推荐使用 importlib.import_module 来替代 __import__，以获得更好的可维护性和清晰度。掌握这两种方式的区别和联系，将使你在构建灵活、可扩展的 Python 应用时更加得心应手。

Although we rarely use __import__ directly in daily development, understanding it helps deepen your knowledge of Python's module import mechanism. For developers who need to dynamically load modules, build plugin systems, or implement framework-level functionality, it is an indispensable knowledge point. Of course, in most cases, it is recommended to use importlib.import_module instead of __import__ for better maintainability and clarity. Mastering the differences and connections between these two methods will make you more proficient in building flexible and scalable Python applications.

今天的分享就到这里了。

如果您对文章有独特的想法，

欢迎给我们留言，

让我们相约明天。

祝您今天过得开心快乐！

That's all for today's sharing.

If you have a unique idea about the article,

please leave us a message,

and let us meet tomorrow.

I wish you a nice day！

参考资料：通义千问

参考文献：Beazley, D., & Jones, B. K. (2019). Python Cookbook (3rd ed.). O'Reilly Media.