Python 包与类的使用指南:__init__.py 的作用与模块引用

键盘旁的猫
键盘旁的猫
发布时间:2026-10-13| 2人浏览过
原创

本文介绍 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 中显式暴露模块内的公用类,以便直接引用。

感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!

相关标签:

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

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 算法库。