Python中模块(Module)和包(Package)的区别详解


Posted in Python onAugust 07, 2019

1. 模块(Module)

在计算机程序的开发过程中,随着程序代码越写越多,在一个文件里代码就会越来越长,越来越不容易维护。
为了编写可维护的代码,我们把很多函数分组,分别放到不同的文件里,这样,每个文件包含的代码就相对较少,很多编程语言都采用这种组织代码的方式。在Python中,一个.py文件就称之为一个模块(Module)。

使用模块有什么好处?

最大的好处是大大提高了代码的可维护性。其次,编写代码不必从零开始。当一个模块编写完毕,就可以被其他地方引用。我们在编写程序的时候,也经常引用其他模块,包括Python内置的模块和来自第三方的模块。

使用模块还可以避免函数名和变量名冲突。相同名字的函数和变量完全可以分别存在不同的模块中,因此,我们自己在编写模块时,不必考虑名字会与其他模块冲突。但是也要注意,尽量不要与内置函数名字冲突。

你也许还想到,如果不同的人编写的模块名相同怎么办?为了避免模块名冲突,Python又引入了按目录来组织模块的方法,称为包(Package)。

举个例子,一个abc.py的文件就是一个名字叫abc的模块,一个xyz.py的文件就是一个名字叫xyz的模块。
现在,假设我们的abc和xyz这两个模块名字与其他模块冲突了,于是我们可以通过包来组织模块,避免冲突。方法是选择一个顶层包名,比如mycompany,按照如下目录存放

mycompany
├─ __init__.py
├─ abc.py
└─ xyz.py

引入了包以后,只要顶层的包名不与别人冲突,那所有模块都不会与别人冲突。现在,abc.py模块的名字就变成了mycompany.abc,类似的,xyz.py的模块名变成了mycompany.xyz。

请注意,每一个包目录下面都会有一个__init__.py的文件,这个文件是必须存在的,否则,Python就把这个目录当成普通目录,而不是一个包。__init__.py可以是空文件,也可以有Python代码,因为__init__.py本身就是一个模块,而它的模块名就是mycompany。

类似的,可以有多级目录,组成多级层次的包结构。比如如下的目录结构:

mycompany
 ├─ web
 │ ├─ __init__.py
 │ ├─ utils.py
 │ └─ www.py
 ├─ __init__.py
 ├─ abc.py
 └─ xyz.py

文件www.py的模块名就是mycompany.web.www

Notes: 自己创建模块时要注意命名,不能和Python自带的模块名称冲突。例如,系统自带了sys模块,自己的模块就不可命名为sys.py,否则将无法导入系统自带的sys模块。

2. 使用模块

Python本身就内置了很多非常有用的模块,只要安装完毕,这些模块就可以立刻使用。

我们以内建的sys模块为例,编写一个hello的模块:

'''
遇到问题没人解答?小编创建了一个Python学习交流QQ群:857662006 
寻找有志同道合的小伙伴,互帮互助,群里还有不错的视频学习教程和PDF电子书!
'''
#!/usr/bin/env python3 
# -*- coding: utf-8 -*-

' a test module '

__author__ = 'Michael Liao'

import sys

def test():
  args = sys.argv  # argv参数用列表存储命令行的所有参数
  if len(args)==1: # 当列表长度为1时即只有一个参数时
    print('Hello, world!')
  elif len(args)==2: # 当命令行有两个参数时
    print('Hello, %s!' % args[1])
  else:
    print('Too many arguments!')

if __name__=='__main__':
  test()

第1行和第2行是标准注释,第1行注释可以让这个hello.py文件直接在Unix/Linux/Mac上运行,第2行注释表示.py文件本身使用标准UTF-8编码;

第4行是一个字符串,表示模块的文档注释,任何模块代码的第一个字符串都被视为模块的文档注释;

第6行使用__author__变量把作者写进去,这样当你公开源代码后别人就可以瞻仰你的大名;

以上就是Python模块的标准文件模板,当然也可以全部删掉不写,但是,按标准办事肯定没错。

后面开始就是真正的代码部分。

你可能注意到了,使用sys模块的第一步,就是导入该模块:

import sys

导入sys模块后,我们就有了变量sys指向该模块,利用sys这个变量,就可以访问sys模块的所有功能。

sys模块有一个argv变量,用list存储了命令行的所有参数。argv至少有一个元素,因为第一个参数永远是该.py文件的名称,例如:

运行python3 hello.py获得的sys.argv就是['hello.py'],注意这里python3不算是参数;

运行python3 hello.py Michael获得的sys.argv就是['hello.py', 'Michael]。

最后,注意到这两行代码:

if __name__=='__main__':
  test()

当我们在命令行运行hello模块文件时,Python解释器把一个特殊变量__name__置为__main__,而如果在其他地方导入该hello模块时,if判断将失败,因此,这种if测试可以让一个模块通过命令行运行时执行一些额外的代码,最常见的就是运行测试。

我们可以用命令行运行hello.py看看效果:

$ python3 hello.py
Hello, world!
$ python hello.py Michael
Hello, Michael!

如果启动Python交互环境,再导入hello模块:

>>> import hello
>>>

导入时,没有打印Hello, word!,因为没有执行test()函数。

调用hello.test()时,才能打印出Hello, word!:

>>> hello.test()
Hello, world!

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Python 相关文章推荐
python算法学习之桶排序算法实例(分块排序)
Dec 18 Python
Python实现的redis分布式锁功能示例
May 29 Python
Python实现的朴素贝叶斯算法经典示例【测试可用】
Jun 13 Python
python 实现一次性在文件中写入多行的方法
Jan 28 Python
远程部署工具Fabric详解(支持Python3)
Jul 04 Python
基于Python安装pyecharts所遇的问题及解决方法
Aug 12 Python
python隐藏类中属性的3种实现方法
Dec 19 Python
python 实现list或string按指定分段
Dec 25 Python
pytorch 利用lstm做mnist手写数字识别分类的实例
Jan 10 Python
Pycharm激活码激活两种快速方式(附最新激活码和插件)
Mar 12 Python
python要安装在哪个盘
Jun 15 Python
Python 操作SQLite数据库的示例
Oct 16 Python
python的常见矩阵运算(小结)
Aug 07 #Python
python字典的setdefault的巧妙用法
Aug 07 #Python
解决Django中调用keras的模型出现的问题
Aug 07 #Python
python 字典 setdefault()和get()方法比较详解
Aug 07 #Python
与Django结合利用模型对上传图片预测的实例详解
Aug 07 #Python
如何用Python来搭建一个简单的推荐系统
Aug 07 #Python
PIL对上传到Django的图片进行处理并保存的实例
Aug 07 #Python
You might like
又一个php 分页类实现代码
2009/12/03 PHP
PHP isset()与empty()的使用区别详解
2010/08/29 PHP
PHP编程之设置apache虚拟目录
2016/07/08 PHP
关于php中的json_encode()和json_decode()函数的一些说明
2016/11/20 PHP
php求数组全排列,元素所有组合的方法总结
2017/03/14 PHP
php微信公众号开发之快递查询
2018/10/20 PHP
Javascript实现的分页函数
2006/12/22 Javascript
Iframe thickbox2.0使用的方法
2009/03/05 Javascript
Javascript 原型和继承(Prototypes and Inheritance)
2009/04/01 Javascript
javascript options属性集合操作代码
2009/12/28 Javascript
jquery和ajax的关系详细介绍
2013/11/29 Javascript
解析JavaScript中delete操作符不能删除的对象
2013/12/03 Javascript
jQuery检测鼠标左键和右键点击的方法
2015/03/17 Javascript
jquery图片滚动放大代码分享(1)
2015/08/25 Javascript
JS、jQuery中select的用法详解
2016/04/21 Javascript
AngularJs bootstrap搭载前台框架——js控制部分
2016/09/01 Javascript
AngularJS 单元测试(二)详解
2016/09/21 Javascript
浅述节点的创建及常见功能的实现
2016/12/15 Javascript
详解js中==与===的区别
2017/01/08 Javascript
jQuery实现获取动态添加的标签对象示例
2018/06/28 jQuery
详解Vue 动态组件与全局事件绑定总结
2018/11/11 Javascript
python笔记(2)
2012/10/24 Python
Python+OpenCV让电脑帮你玩微信跳一跳
2018/01/04 Python
python+matplotlib绘制3D条形图实例代码
2018/01/17 Python
利用python的socket发送http(s)请求方法示例
2018/05/07 Python
关于Python的一些学习总结
2018/05/25 Python
Python面向对象程序设计之私有变量,私有方法原理与用法分析
2020/03/23 Python
个人求职简历中英文自我评价
2013/12/16 职场文书
大学新闻系自荐书
2014/05/31 职场文书
大学生学习计划书
2014/09/15 职场文书
基层领导干部“四风”问题批评与自我批评
2014/09/23 职场文书
民主评议党员自我鉴定
2014/10/21 职场文书
2015年党支部公开承诺书
2015/01/22 职场文书
创业计划书之网络外卖
2019/10/31 职场文书
有趣的二维码:使用MyQR和qrcode来制作二维码
2021/05/10 Python
OpenCV实现反阈值二值化
2021/11/17 Java/Android