《Python 模块与包入门:import 的基本用法》

举报
yd_221894022 发表于 2026/11/17 19:43:49 2026/11/17
【摘要】 一、模块是什么Python 的模块就是一个以 .py 结尾的 Python 源文件。每个模块都是一个独立的名字空间,里面可以放函数、类、变量和可执行的语句。把代码拆成模块,好处很实在:代码可以复用、便于分工维护、名字不会到处冲突。比如你写了一个 tools.py,里面放了几个常用的小函数,别的脚本只要导入它就能直接用,不必把同一段代码复制很多份。标准库本身就是由大量模块组成的,例如 mat...

一、模块是什么

Python 的模块就是一个以 .py 结尾的 Python 源文件。每个模块都是一个独立的名字空间,里面可以放函数、类、变量和可执行的语句。把代码拆成模块,好处很实在:代码可以复用、便于分工维护、名字不会到处冲突。比如你写了一个 tools.py,里面放了几个常用的小函数,别的脚本只要导入它就能直接用,不必把同一段代码复制很多份。标准库本身就是由大量模块组成的,例如 math、os、datetime,学会导入模块,就等于打开了 Python 生态的大门。

二、import 与 from import

最常见的导入方式有两种。第一种是 import 模块名:

import math
print(math.sqrt(16))  # 4.0

这种方式把整个模块导入,使用时要写模块名前缀,名字清晰、不容易冲突。第二种是 from 模块名 import 名字:

from math import sqrt, pi
print(sqrt(16), pi)

它只导入指定的名字,用起来更短,但如果导入的名字和自己代码里的名字重复,就会被覆盖。还有一种写法是 from math import *,它把模块里所有公开名字一次性导入,写起来省事,但容易造成命名冲突,新手最好少用。给模块起别名也很常见,例如 import numpy as np,既简短又保留了前缀,阅读代码时一眼就能看出函数来自哪个模块。

三、模块搜索路径

执行 import 时,Python 会按固定顺序去找模块:先找内置模块,再找当前脚本所在的目录,接着找 PYTHONPATH 环境变量里的目录,最后找标准库和第三方库的安装目录。这个顺序保存在 sys.path 这个列表里:

import sys
for p in sys.path:
    print(p)

理解搜索路径能帮你排掉很多常见错误:比如自己写的文件名和标准库重名(把文件命名为 math.py 就可能让 import math 导入了自己的文件),或者脚本在别的目录运行时找不到同级模块。这时可以把模块所在目录加进 sys.path,或者把代码装成一个包来解决。

四、包与 __init__.py

当模块越来越多时,可以用包来组织。包就是包含 __init__.py 文件的文件夹,文件夹里的 .py 文件都是这个包的模块。例如目录结构:

shop/
    __init__.py
    cart.py
    user.py

导入时写成 import shop.cart,点号就表示层级关系。__init__.py 在包被导入时最先执行,可以是空文件,也可以用来统一导出包里的常用名字,或者做初始化工作。Python 3.3 之后,没有 __init__.py 的文件夹也可以当作命名空间包使用,但显式放一个 __init__.py 仍然是更清晰、更稳妥的做法,别人一眼就能看出这是一个包。

五、__name__ == "__main__" 的作用

每个模块都有一个内置变量 __name__。当一个文件被直接运行时,它的 __name__ 是 "__main__";当它被别的模块导入时,__name__ 就是它自己的模块名。利用这一点,可以把“测试代码”和“被导入的功能”分开:

def greet(name):
    return f"你好,{name}"

if __name__ == "__main__":
    print(greet("小明"))

这样,直接运行这个文件时会执行测试打印,而被别人 import 时只会导入 greet 函数,不会顺带执行测试代码。这是一个非常实用的习惯:写模块时把可复用的功能放在前面,把自测代码放进 if __name__ == "__main__": 里,既方便调试,又不打扰使用者。

六、小结

模块让代码有了可复用的单元,包让模块有了清晰的层级,import 与 from import 是使用它们的两种基本方式,sys.path 决定了模块从哪里找,而 __name__ == "__main__" 则让一个文件既能当工具被导入,也能自己独立运行。掌握这几个概念,就掌握了组织 Python 代码的基本功。接下来可以试着把自己常用的函数抽成模块,再用包把它们组织起来,写出更整洁的项目。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。