Python 包与类的使用指南：__init__.py 的作用与模块引用
发布时间：2026-10-13 |
4人浏览过
本文介绍 Python 中包（Package）的创建方法及 __init__.py 文件的核心作用。通过演示如何构建 filePackage 包、定义 MyFile 类，并对比直接导入与在 __init__.py 中暴露接口的两种引用方式，帮助开发者理解如何规范化管理模块，提升代码的可读性与维护性。
Python 基础教程之包和类的用法
首先，创建一个名为 filePackage 的文件夹。
接着，在该 filePackage 文件夹内部创建一个名为 __init__.py 的文件。
__init__.py 文件的存在标志着 filePackage 成为一个合法的 Python 包；若缺少该文件，该目录仅被视为普通文件夹，无法被作为包导入。
随后，在 filePackage 文件夹内创建 file.py 文件。
file.py 的具体代码实现如下：
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from datetime import datetime
class MyFile():
def __init__(self, filepath):
print('MyFile init...')
self.filepath = filepath
def printFilePath(self):
print(self.filepath)
def testReadFile(self):
with open(self.filepath, 'r') as f:
s = f.read()
print('open for read...')
print(s)
def testWriteFile(self):
with open('test.txt', 'w') as f:
f.write('今天是 ')
f.write(datetime.now().strftime('%Y-%m-%d'))
__init__.py 的代码内容如下：
from file import MyFile
其核心目的是将模块内部共用的类和方法暴露给外部，无需深入模块内部细节。
通过这种方式，外部引用代码无需知晓具体的文件路径，只需定位到包的 __init__.py 即可直接调用。
接下来，在与 filePackage 目录平级的层级建立 main.py 文件。
main.py 的代码示例如下：
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from filePackage import MyFile
if __name__ == '__main__':
a = MyFile("./filePackage/test.txt")
a.printFilePath();
a.testReadFile();
整体的目录结构如下图所示：
如果 __init__.py 文件内容为空，在 main.py 中也可以采用另一种导入方式：
import filePackage.file
if __name__ == '__main__':
a = filePackage.file.MyFile("./filePackage/test.txt")
a.printFilePath();
虽然上述方式可行，但并不推荐。建议遵循前文方法，在 __init__.py 中显式暴露模块内的公用类，以便直接引用。
感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！
本站声明
本文内容仅供参考，不代表本站观点。转载或引用请注明出处。如发现内容问题，请通过联系我们页面反馈。
