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写一个无界面的2048小游戏
May 24 Python
Python函数的周期性执行实现方法
Aug 13 Python
Python数据可视化编程通过Matplotlib创建散点图代码示例
Dec 09 Python
python调用百度REST API实现语音识别
Aug 30 Python
Python 多线程不加锁分块读取文件的方法
Dec 11 Python
python 执行文件时额外参数获取的实例
Dec 18 Python
django formset实现数据表的批量操作的示例代码
Dec 06 Python
python如何实现DES加密
Sep 21 Python
pycharm进入时每次都是insert模式的解决方式
Feb 05 Python
如何使用Python实现一个简易的ORM模型
May 12 Python
教你用python控制安卓手机
May 13 Python
pandas时间序列之pd.to_datetime()的实现
Jun 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 dirname(__FILE__) 获取当前文件的绝对路径
2011/06/28 PHP
PHP常用数组函数介绍
2014/07/28 PHP
php 函数使用可变数量的参数方法
2017/05/02 PHP
通过PHP实现用户注册后邮箱验证激活
2020/11/10 PHP
用javascript控制iframe滚动的代码
2007/04/10 Javascript
DWZ刷新dialog解决方法
2013/03/03 Javascript
javascript显示用户停留时间的简单实例
2013/08/05 Javascript
JavaScript实现维吉尼亚(Vigenere)密码算法实例
2013/11/22 Javascript
利用JavaScript脚本实现滚屏效果的方法
2015/07/07 Javascript
11种ASP连接数据库的方法
2015/09/18 Javascript
ReactNative页面跳转实例代码
2016/09/27 Javascript
jQuery实现select模糊查询(反射机制)
2017/01/14 Javascript
TableSort.js表格排序插件使用方法详解
2017/02/10 Javascript
微信公众号菜单配置微信小程序实例详解
2017/03/31 Javascript
anime.js 实现带有描边动画效果的复选框(推荐)
2017/12/24 Javascript
jQuery实现网页拼图游戏
2020/04/22 jQuery
如何让Nodejs支持H5 History模式(connect-history-api-fallback源码分析)
2019/05/30 NodeJs
这15个Vue指令,让你的项目开发爽到爆
2019/10/11 Javascript
react MPA 多页配置详解
2019/10/18 Javascript
解决vue的过渡动画无法正常实现问题
2019/10/31 Javascript
Antd的table组件表格的序号自增操作
2020/10/27 Javascript
jQuery实现增删改查
2020/12/22 jQuery
使用pycharm生成代码模板的实例
2018/05/23 Python
利用Python实现在同一网络中的本地文件共享方法
2018/06/04 Python
用python拟合等角螺线的实现示例
2019/12/27 Python
Pytorch在NLP中的简单应用详解
2020/01/08 Python
详解Python中list[::-1]的几种用法
2020/11/16 Python
Melijoe英国官网:法国儿童时尚网站
2016/11/18 全球购物
Canal官网:巴西女性时尚品牌
2019/10/16 全球购物
应用心理学个人的求职信
2013/12/08 职场文书
法律进机关实施方案
2014/03/12 职场文书
沂蒙六姐妹观后感
2015/06/08 职场文书
基于MySql验证的vsftpd虚拟用户
2021/11/07 MySQL
vue判断按钮是否可以点击
2022/04/09 Vue.js
Python万能模板案例之matplotlib绘制直方图的基本配置
2022/04/13 Python
CSS 左边固定宽右边自适应的6种方法
2022/05/15 HTML / CSS