Python包,__init__.py功能与用法分析

季宁
季宁
发布时间:2026-10-13| 6人浏览过
原创

本文详解Python中__init__.py文件在包组织中的核心作用,包括初始化设置与__all__控制。通过目录结构示例与代码演示,展示如何导入子模块、利用__all__限制批量导入范围,帮助开发者规范Python包结构。

Python包与__init__.py基础

本文详细介绍Python中__init__.py文件的功能及其具体用法,旨在为读者提供清晰的参考指南。

  • 为了有效管理模块,通常将多个相关模块组合成一个包,包的主要作用是存放Python模块。
  • 在文件系统中,包通常表现为一个文件夹。当该文件夹被用作包时,必须包含__init__.py文件。
  • __init__.py文件的内容可以为空,但通常用于执行包的初始化操作或设置__all__变量。__all__用于控制from ... import *语句的行为,其中列出的模块会被全部导入。

包结构与模块导入示例

目录结构如下:

test1模块的代码内容:

package_test包下的__init__.py文件代码:

inner子模块的代码内容:

__init__.py与__all__的高级用法

以下代码演示如何导入包中的test1模块以及子包中的inner模块:


from package_test import test1

from package_test.child_package import inner



#-----------------运行结果:
run in package_test.__init__.py
import test1 done
run in inner

  • 实现批量导入所需模块的方法如下:

__init__.py文件的具体代码:

通过b文件导入package_test包的代码示例:


import package_test

print(package_test.re,package_test.bs4)


#--------------
#运行结果:
<module 're' from 'I:\\python3\\lib\\re.py'> <module 'bs4' from 'I:\\python3\\lib\\site-packages\\bs4\\__init__.py'>
  • __all__变量用于指定全部导入的模块。与直接导入不同,__all__仅允许导入包中明确列出的模块:

相关目录结构如下:

__init__.py文件代码:


__all__=['test1']

通过b文件导入package_test包的代码:


from package_test import *

如果您对Python有其他兴趣,可参考本站专题:《Python函数使用技巧总结》、《Python面向对象程序设计入门与进阶教程》、《Python数据结构与算法教程》、《Python字符串操作技巧汇总》、《Python编码操作技巧总结》及《Python入门与进阶经典教程》。

希望本文的内容能对您的Python编程学习有所帮助。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。