Python模块与包教程1. 模块的概念在Python中模块(Module)是一个包含Python定义和语句的文件文件名就是模块名加上.py后缀。使用模块可以将相关代码组织在一起提高代码的可维护性和复用性。模块的优势提高代码可维护性将代码分解为逻辑单元代码复用可以导入其他模块的功能避免重复造轮子命名空间管理避免命名冲突相同名称的函数/变量可以存在于不同模块中性能优化Python会缓存编译后的模块(.pyc文件)提高加载速度2. 包(Package)的概念包是一种用目录结构组织模块的方式用于解决模块名冲突的问题。一个包是一个包含__init__.py文件的目录。包的结构示例myproject/ ├── __init__.py ├── main.py ├── utils/ │ ├── __init__.py │ ├── file_utils.py │ └── math_utils.py └── models/ ├── __init__.py ├── user.py └── product.py__init__.py文件的作用标识目录为Python包可以包含包的初始化代码控制from package import *的行为(通过定义__all__列表)现代Python(3.3)中__init__.py不再是必需的但建议保留以保持兼容性3. 模块导入方式基本导入方式# 导入整个模块importmodule_name# 导入特定内容frommodule_nameimportfunction_name# 导入并重命名importmodule_nameasaliasfrommodule_nameimportfunction_nameasfn_alias# 导入包中的模块frompackage_nameimportmodule_name相对导入(在包内部使用)# 从当前包导入同级模块from.importmodule_name# 从上级包导入模块from..importmodule_name# 从子包导入模块from.subpackageimportmodule_name4. 模块搜索路径Python解释器按以下顺序查找模块内置模块sys.path列表中的目录(按顺序):包含输入脚本的目录(或当前目录)PYTHONPATH环境变量指定的目录安装依赖的默认路径(如site-packages)查看当前搜索路径importsysprint(sys.path)5. 最佳实践模块命名规范使用小写字母和下划线(my_module.py)避免与Python标准库模块重名检查名称是否已存在import module_name测试包设计建议保持包结构扁平化避免过深的嵌套在__init__.py中明确定义公共API(使用__all__)考虑使用__main__.py为包提供命令行接口导入建议在文件顶部集中导入按标准库、第三方库、本地模块分组导入避免使用from module import *(污染命名空间)优先使用绝对导入(明确性更好)特殊模块变量# 模块的文档字符串__doc__# 模块名(字符串)__name__# 模块的文件路径__file__# 包路径(列表)__path__6. 现代Python模块特性命名空间包(Python 3.3)不需要__init__.py文件允许多个目录共同构成一个包适用于大型项目或插件系统类型提示支持可以在模块中使用类型注解支持.pyi存根文件为模块提供类型信息模块缓存Python会缓存编译后的字节码(.pyc文件)提高模块加载速度缓存位于__pycache__目录中7. 示例模块与包的实际应用模块示例(math_utils.py) 数学工具模块 提供常用的数学计算函数 defadd(a:float,b:float)-float:返回两个数的和returnabdefmultiply(a:float,b:float)-float:返回两个数的乘积returna*b# 模块自测试if__name____main__:print(测试:,add(2,3))# 应输出5包结构示例myapp/ ├── __init__.py ├── main.py └── utils/ ├── __init__.py ├── math_utils.py └── string_utils.py__init__.py示例 myapp.utils 工具包 # 明确公开的API__all__[math_utils,string_utils]# 包版本__version__1.0.0使用示例# main.pyfromutils.math_utilsimportadd,multiply resultadd(10,20)print(f10 20 {result})通过合理使用模块和包可以构建出结构清晰、易于维护的大型Python项目。想要解锁更多 Python 实战黑科技搜索「道满PythonAI」海量免费教程随你练边学边练进步更快下一篇想学 Python 什么内容评论区告诉我觉得有用就点赞 关注持续更新干货
别再写杂乱代码了！Python 模块与包的正确使用姿势
Python模块与包教程1. 模块的概念在Python中模块(Module)是一个包含Python定义和语句的文件文件名就是模块名加上.py后缀。使用模块可以将相关代码组织在一起提高代码的可维护性和复用性。模块的优势提高代码可维护性将代码分解为逻辑单元代码复用可以导入其他模块的功能避免重复造轮子命名空间管理避免命名冲突相同名称的函数/变量可以存在于不同模块中性能优化Python会缓存编译后的模块(.pyc文件)提高加载速度2. 包(Package)的概念包是一种用目录结构组织模块的方式用于解决模块名冲突的问题。一个包是一个包含__init__.py文件的目录。包的结构示例myproject/ ├── __init__.py ├── main.py ├── utils/ │ ├── __init__.py │ ├── file_utils.py │ └── math_utils.py └── models/ ├── __init__.py ├── user.py └── product.py__init__.py文件的作用标识目录为Python包可以包含包的初始化代码控制from package import *的行为(通过定义__all__列表)现代Python(3.3)中__init__.py不再是必需的但建议保留以保持兼容性3. 模块导入方式基本导入方式# 导入整个模块importmodule_name# 导入特定内容frommodule_nameimportfunction_name# 导入并重命名importmodule_nameasaliasfrommodule_nameimportfunction_nameasfn_alias# 导入包中的模块frompackage_nameimportmodule_name相对导入(在包内部使用)# 从当前包导入同级模块from.importmodule_name# 从上级包导入模块from..importmodule_name# 从子包导入模块from.subpackageimportmodule_name4. 模块搜索路径Python解释器按以下顺序查找模块内置模块sys.path列表中的目录(按顺序):包含输入脚本的目录(或当前目录)PYTHONPATH环境变量指定的目录安装依赖的默认路径(如site-packages)查看当前搜索路径importsysprint(sys.path)5. 最佳实践模块命名规范使用小写字母和下划线(my_module.py)避免与Python标准库模块重名检查名称是否已存在import module_name测试包设计建议保持包结构扁平化避免过深的嵌套在__init__.py中明确定义公共API(使用__all__)考虑使用__main__.py为包提供命令行接口导入建议在文件顶部集中导入按标准库、第三方库、本地模块分组导入避免使用from module import *(污染命名空间)优先使用绝对导入(明确性更好)特殊模块变量# 模块的文档字符串__doc__# 模块名(字符串)__name__# 模块的文件路径__file__# 包路径(列表)__path__6. 现代Python模块特性命名空间包(Python 3.3)不需要__init__.py文件允许多个目录共同构成一个包适用于大型项目或插件系统类型提示支持可以在模块中使用类型注解支持.pyi存根文件为模块提供类型信息模块缓存Python会缓存编译后的字节码(.pyc文件)提高模块加载速度缓存位于__pycache__目录中7. 示例模块与包的实际应用模块示例(math_utils.py) 数学工具模块 提供常用的数学计算函数 defadd(a:float,b:float)-float:返回两个数的和returnabdefmultiply(a:float,b:float)-float:返回两个数的乘积returna*b# 模块自测试if__name____main__:print(测试:,add(2,3))# 应输出5包结构示例myapp/ ├── __init__.py ├── main.py └── utils/ ├── __init__.py ├── math_utils.py └── string_utils.py__init__.py示例 myapp.utils 工具包 # 明确公开的API__all__[math_utils,string_utils]# 包版本__version__1.0.0使用示例# main.pyfromutils.math_utilsimportadd,multiply resultadd(10,20)print(f10 20 {result})通过合理使用模块和包可以构建出结构清晰、易于维护的大型Python项目。想要解锁更多 Python 实战黑科技搜索「道满PythonAI」海量免费教程随你练边学边练进步更快下一篇想学 Python 什么内容评论区告诉我觉得有用就点赞 关注持续更新干货
