第 21 章 站在巨人的肩膀上:模块与包
📖 本章目标:学会用 import 引入现成的"轮子",掌握常用标准库,还会写自己的模块。
学完本章,你写程序再也不用从零开始——Python 自带一个巨大的"工具箱"。
前面你写的每一行代码都是"自己手搓"。本章起,你学会"借"。Python 标准库就是一座现成的零件仓库,学会开仓库的门,你的生产力直接翻十倍。
【开场小剧场】轮子工厂
学生: 皮皮,我想要随机数,还得自己写一个?好麻烦。
皮皮: 你见过谁造车先自己炼钢、造轮子的?编程也一样——别重复造轮子。Python 自带一个巨大的"轮子仓库",叫标准库,里面应有尽有。
学生: 那怎么拿?
皮皮: 一句话:import。今天教你"开仓库的门",顺便学会把你自己写的工具也放进仓库里。
学生: 借别人的轮子……会不会出问题?
皮皮: (挤眉弄眼)所以你得会看"使用说明",还要知道"这轮子打滑时怎么防"。今天就教你这些。
21.1 模块:一个 .py 文件就是一个模块
模块(module) 就是"装了一堆函数的 .py 文件"。Python 的标准库有几百个现成模块:
random:随机数、洗牌、抽奖;math:数学函数(开根号、取整、π);time/datetime:时间日期;os:操作系统(文件、路径、目录)。
一句话:别人(或 Python 官方)写好的 .py 文件,你 import 一下就能用。 这就是"站在巨人的肩膀上"。
逐项拆解这四个常用模块:
- random:"抽奖箱"。randint 掷骰子、choice 点名、shuffle 洗牌——一切"碰运气"的活都找它;
- math:"数学计算器"。开根号、取整、圆周率,比手写 x ** 0.5 更清晰;
- time:"计时员"。拿时间戳、让程序睡觉(sleep);
- os:"系统管理员"。操作文件路径、目录、改名删文件(第 29 章细讲)。
💡 想确认一个模块有没有装,直接
import它:不报ModuleNotFoundError就说明有。标准库随 Python 一起安装,不需要额外下载。
21.2 import 的三种姿势
姿势一:import 模块名,用 模块名.函数
import random
num = random.randint(1, 6) # 随机 1~6 的整数
print("骰子点数:", num)
逐行拆解:
- import random:开仓库的门,把整个 random 模块"借"进来;
- random.randint(1, 6):用 模块名.函数 的方式调用——明确告诉 Python"这个函数是 random 家的"。
特点:函数前带模块名,一眼看清"这个函数是谁家的",不容易起冲突。
姿势二:import 加别名 as,手短好打字
import random as r
num = r.randint(1, 6) # 用别名 r 代替 random
as r 给模块起个小名。什么时候用? 模块名特别长(比如 numpy)时,给个短别名,省得每次打一大串。别名只是"换了个叫法",功能一模一样。
姿势三:from 模块 import 函数,直接用函数名
from random import randint
num = randint(1, 6) # 直接用,不带前缀
逐行拆解:
- from random import randint:从 random 里"点名"取走 randint 这一个函数;
- 之后用 randint(1, 6) 直接调用,不带前缀。
特点:省字,但容易和别处同名函数冲突(比如自己写的 randint 会盖掉它)。
换例加深:三种姿势选哪个?
| 姿势 | 写法 | 调用 | 冲突风险 |
|---|---|---|---|
| ① 直接 import | import random |
random.randint() |
低 |
| ② 别名 | import random as r |
r.randint() |
低 |
| ③ from 导入 | from random import randint |
randint() |
中 |
🐍"皮皮注:新手阶段,优先用姿势一(
import random+random.xxx)。虽然多打几个字,但代码清楚、不怕重名。别问,问就是防坑。"
易错提醒: 姿势三一次可以取多个:from math import sqrt, pi,之后 sqrt 和 pi 都能直接用。但记得——别取太多,把半个模块都 from import 进来,重名风险也跟着涨。
21.3 random:命运的骰子
import random
print(random.randint(1, 100)) # 随机整数 1~100
print(random.choice(["剪刀", "石头", "布"])) # 随机选一个
print(random.shuffle([1, 2, 3, 4, 5])) # 洗牌(注意:返回 None,原地打乱)
逐行拆解:
- random.randint(1, 100):闭区间,1 和 100 都包含(第 10 章猜数字就用它);
- random.choice(列表):从列表里随机挑一个元素(点名神器);
- random.shuffle(列表):原地打乱列表顺序,返回 None(别赋值,见翻车现场坑 2)。
注意 random.shuffle 是原地打乱并返回 None,别把它赋给变量:
cards = [1, 2, 3, 4, 5]
random.shuffle(cards) # 直接在 cards 上打乱
print(cards) # 顺序已经乱了
换例加深:随机浮点数
print(random.random()) # 0~1 之间的随机小数,如 0.5731...
print(random.uniform(1, 10)) # 1~10 之间的随机小数
random() 给你一个 0 到 1 的小数(不含 1);uniform(a, b) 给你 a 到 b 之间的小数。整数找 randint,小数找 uniform。
配套代码文件:code/ch21/dice.py。
💡 提示: 第 10 章的猜数字游戏里你已经见过
random.randint了——现在你知道了,那只是"借轮子"的一个小例子。
21.4 math:计算好帮手
import math
print(math.sqrt(16)) # 开根号 → 4.0
print(math.floor(3.9)) # 向下取整 → 3
print(math.ceil(3.1)) # 向上取整 → 4
print(math.pi) # 圆周率
print(math.pow(2, 10)) # 2 的 10 次方 → 1024.0
逐行拆解:
- math.sqrt(16):开根号。注意结果带 .0(返回浮点数);
- math.floor(3.9):向下取整(往小的方向),3.9 → 3;
- math.ceil(3.1):向上取整(往大的方向),3.1 → 4;
- math.pi:一个常量,圆周率 3.14159...;
- math.pow(2, 10):幂运算,等价于 2 ** 10,返回浮点数。
实战:求圆的面积
import math
r = float(input("请输入圆的半径:"))
area = math.pi * r ** 2
print(f"面积:{area:.2f}")
逐行拆解:
- r = float(input(...)):读入半径并转成小数(允许 3.5 这种值);
- area = math.pi * r ** 2:面积公式 πr²。注意 r ** 2 先算,再乘 π(优先级,第 4 章学的);
- f"面积:{area:.2f}":保留两位小数输出。
换例加深:math 里还有几个常用的
print(math.fabs(-5)) # 绝对值 → 5.0
print(math.factorial(5)) # 阶乘 → 120(第 18 章递归版还记得吗)
print(math.gcd(12, 18)) # 最大公约数 → 6
看到了吗? math.factorial 一行搞定你第 18 章用递归写的阶乘——这就是"借轮子"的意义。
💡 取整三兄弟别混:
int(3.9)是直接砍掉小数(→3),floor向下取整(→3),ceil向上取整(→4)。对正数,int和floor一样;对负数就不一样了(int(-3.9)=-3,floor(-3.9)=-4)。
21.5 time:时间怎么拿
import time
print(time.time()) # 从 1970 年到现在经过的秒数(时间戳)
time.sleep(1) # 让程序暂停 1 秒
print("睡醒了")
逐行拆解:
- time.time():返回一个巨大的浮点数,叫时间戳——1970 年 1 月 1 日到现在的秒数。计算机内部记时间就用它;
- time.sleep(1):让程序暂停 1 秒,再继续往下走;
- print("睡醒了"):睡醒才打印。
time.sleep(秒) 常用于"程序等一等"。比如倒计时、限速请求。更漂亮的时间格式在 datetime(第 29 章),先混个脸熟。
换例加深:一个简单的倒计时
import time
for i in range(5, 0, -1):
print(f"倒计时 {i} 秒...")
time.sleep(1)
print("时间到!")
逐行拆解:
- for i in range(5, 0, -1):从 5 数到 1(第 9 章学的负步长 range);
- time.sleep(1):每次数完停 1 秒,让倒计时有真实节奏;
- print("时间到!"):结束。
配套代码文件:code/ch21/math_time_demo.py。
💡 提示:
sleep的单位是秒,想暂停 0.5 秒就写time.sleep(0.5)。小数也支持。
21.6 自己写模块:我的轮子我做主
模块的本质就是 .py 文件。所以你可以自己写一个 .py 文件,存一堆函数,然后在别的文件里 import 它!
第一步:创建 my_tools.py(工具模块)
# my_tools.py —— 皮皮的私人工具箱
def add(a, b):
return a + b
def say_hi(name):
return f"你好,{name}!"
PI = 3.14159
第二步:在另一个文件里 import 它
# main.py
import my_tools
print(my_tools.add(3, 5)) # 8
print(my_tools.say_hi("小明")) # 你好,小明!
print(my_tools.PI) # 3.14159
逐行拆解:
- import my_tools:导入你自己写的模块,用法和标准库一模一样;
- my_tools.add(3, 5):调你自己写的函数;
- my_tools.PI:连模块里的变量/常量也能通过 模块名.常量 访问。
关键条件:两个文件要在同一个文件夹里。 这样 Python 才能找到你的模块。
换例加深:从自己的模块 from import
# main.py
from my_tools import add, PI
print(add(1, 2)) # 3
print(PI) # 3.14159
你自己的模块也能 from import! 写代码的方式和用标准库完全一致——因为标准库本来也就是别人写的 .py 文件。
💡 为什么不把所有代码写进一个文件? 因为模块化让代码可以复用和分工:写一次,到处用;一个人写这个文件,另一个人写那个文件,互不干扰。第 22 章的项目会实践这一点。
21.7 name == "main":天才的分界点
有个小问题:如果 my_tools.py 里除了函数,还有测试代码:
# my_tools.py
def add(a, b):
return a + b
print("模块被加载了!") # ❌ import 时也会打印,很烦
别人 import my_tools 时,这行 print 也会执行——模块不该在导入时乱响。解决办法:把"自己测试用的代码"藏进这个魔法判断里:
# my_tools.py
def add(a, b):
return a + b
if __name__ == "__main__":
print("直接运行这个文件才打印,import 时不会")
print(add(3, 5))
规律:
- 直接运行 my_tools.py → __name__ 的值是 "__main__" → 判断成立,执行;
- 被 import → __name__ 的值是模块名 "my_tools" → 判断不成立,跳过。
逐行拆解:
- if __name__ == "__main__"::__name__ 是 Python 自动给每个文件设的一个隐藏变量;
- 它只在"直接运行这个文件"时等于字符串 "__main__";
- 判断成立,执行里面的测试代码;不成立(被 import),整块跳过。
用一句话记:__name__ == "__main__" 里面放"只有直接运行时才要干的事"。 这是 Python 里最常见的魔法,每个正式文件都长这样。
配套代码文件:code/ch21/my_tools.py。
🐍"皮皮注:这块魔法判断就像'员工证'——你是被直接叫来的,还是被介绍来的? 被直接运行(亲自上阵)就干活,被 import(来参观)就闭嘴。写任何带测试代码的模块,都记得给它挂上这张证。"
【皮皮小课堂】本章要点
- 模块 = 一个 .py 文件;标准库 = Python 自带的"轮子仓库"。
- import 三姿势:
import random(推荐)、import random as r(别名)、from random import randint(直接用)。 - random:
randint随机整数、choice随机选、shuffle洗牌(原地打乱)。 - math:
sqrt/floor/ceil/pi/pow。 - time:
time()时间戳、sleep(秒)暂停。 - 自定义模块:把自己的 .py 文件放同目录,
import 文件名就能用。 if __name__ == "__main__"::只放"直接运行时才执行的代码",import 时不执行。
【翻车现场】本章的坑
坑 1:文件名当模块名,撞了标准库
# 你的文件叫 random.py —— 完蛋
import random # 导入了你自己,不是标准库!
文件名取了标准库的名字(如 random.py、math.py),Python 会优先找当前目录的文件,把标准库"顶掉",各种报错。文件名别用标准库名。
坑 2:shuffle 赋给变量,得到 None
cards = random.shuffle([1, 2, 3, 4]) # ❌ None!
print(cards) # None
shuffle 原地打乱并返回 None。先建列表,再原地 shuffle,最后用原列表。
坑 3:from import 忘了函数名 / 拼错
from random import randint
num = randint(1, 6) # 没问题
from random import randit # ❌ 拼错了,ModuleNotFoundError
拼错模块名报 ModuleNotFoundError,拼错函数名报 ImportError。看到这两个错,先检查拼写。
坑 4:自定义模块不在同一个文件夹
import my_tools # ModuleNotFoundError: 因为 my_tools.py 不在当前目录
Python 只在特定位置找模块(包括当前目录)。把你的模块文件和主文件放同一目录。 第 29 章会讲用 os 拼路径更规范。
坑 5:import 的模块里带测试代码
# my_tools.py
def add(a, b):
return a + b
print("随便测试") # 别人 import 时也会执行,很吵
测试代码要包进 if __name__ == "__main__":,这样只在直接运行时执行。
坑 6:from ... import * 一把梭
from random import * # ❌ 一次性把所有名字都导进来
星号会导入模块里的所有名字,相当于把一堆不认识的名字全塞进你的命名空间——重名风险瞬间爆炸。新手别用 * 导入,老实写 import random 或用明确的 from。
【本章习题】
一、选择题
1. (★) 想用 random.randint(1, 10),正确的导入方式是?
- A.
import random - B.
random import - C.
from random - D.
use random
2. (★★) random.shuffle(cards) 执行后,cards 发生了什么?
- A. 返回一个打乱后的新列表,原列表不变
- B. 原地打乱
cards本身 - C. 报错,shuffle 只能用于字符串
- D. 返回 True
3. (★★) 下面的文件 my_tools.py:
print("A")
if __name__ == "__main__":
print("B")
在另一个文件里 import my_tools 后,会打印什么?
- A. 什么都不打印
- B.
A - C.
B - D.
A和B
4. (★★) 执行 import math,下面哪个表达式的结果是 3?
- A.
math.sqrt(16) - B.
math.floor(4.9) - C.
math.ceil(2.9) - D.
math.pow(2, 4)
5. (★★ 多选) 关于 import,下列说法正确的是?
- A.
import random as r之后,可以用r.randint()调用 - B.
from math import sqrt之后,可以直接用sqrt(9) - C. 模块本质上是一个 .py 文件
- D. 自己写的工具模块必须和主文件放在同一目录才能被 import
二、判断题
1. (★) 标准库是 Python 自带的,不需要额外下载安装。( )
2. (★★) 如果你的文件名叫 math.py,import math 仍会导入 Python 标准库的 math。( )
3. (★★) 用 if __name__ == "__main__": 包起来的代码,在文件被 import 时不会执行。( )
4. (★★) random.randint(1, 6) 的结果包含 1 和 6 两端。( )
三、代码纠错题
1. (★★) 下面代码想打印一个打乱后的列表,但结果输出 None,请改正:
import random
cards = random.shuffle([1, 2, 3, 4, 5])
print(cards)
2. (★★) 下面代码一运行就报 ModuleNotFoundError,请指出原因并改正:
# 文件目录结构:
# D:/我的项目/main.py
# D:/我的项目/工具/my_tools.py
import my_tools
print(my_tools.add(1, 2))
四、编程实战题
1. (基础 ★) 写一个"双骰子模拟器":每次运行随机掷两个骰子(1~6),打印点数之和。
2. (基础 ★★) 写一个"随机点名器":用 random.choice 从名字列表里随机抽一个打印。
3. (基础 ★★) 写一个"密码生成器":用 random.choice 从 "abcdefghijklmnopqrstuvwxyz0123456789" 里随机取 8 个字符拼成一个密码(提示:循环 8 次,每次 + 拼一个字符)。
4. (挑战 ★★★) 自己写一个模块 calculator.py,包含 add/sub/mul/div 四个函数;再写一个 main.py 导入它,让用户输入两个数和一个运算符,输出结果(除数为 0 时用异常处理兜底)。
【参考答案与解析】
一、选择题
1. 答案:A
import random 然后 random.randint() 使用。
2. 答案:B
shuffle 是原地打乱,返回 None,原列表被改变。
3. 答案:B
被 import 时 __name__ 不是 "__main__",print("B") 不执行;但模块顶层代码 print("A") 会执行。所以只打印 A。
4. 答案:C
math.ceil(2.9) 向上取整 → 3。A 是 4.0(浮点),B 是 4,D 是 16.0。
5. 答案:A、B、C、D
A 对:别名 r 可替代 random;B 对:from import 直接用函数名;C 对:模块本质是 .py 文件;D 对:自定义模块要和主文件同目录(或配置路径)。
二、判断题
1. 正确(√)。标准库随 Python 一起安装,直接 import 即可。
2. 错误(×)。如果当前目录有 math.py,Python 优先找它,标准库的 math 被顶掉,各种报错。别用标准库名当文件名。
3. 正确(√)。__name__ 在被 import 时是模块名,不是 "__main__",判断不成立。
4. 正确(√)。randint(a, b) 是闭区间,包含两端。
三、代码纠错题
1. 解析: shuffle 原地打乱并返回 None。改正:先建列表,再打乱,再打印:
import random
cards = [1, 2, 3, 4, 5]
random.shuffle(cards)
print(cards)
2. 解析: my_tools.py 在 工具 子文件夹里,而 main.py 在 我的项目 里——Python 只认当前目录(和特定路径),找不到 my_tools。两个办法:
# 办法 1:把 my_tools.py 移到和 main.py 同一个文件夹
import my_tools
print(my_tools.add(1, 2)) # 3
# 办法 2:显式告诉 Python 去 工具 文件夹里找
import sys
sys.path.append("工具") # 把"工具"文件夹加进搜索路径
import my_tools
print(my_tools.add(1, 2)) # 3
核心: 模块放在"Python 找得到的地方"——同目录,或用 sys.path 把文件夹加进搜索路径。
四、编程实战题
1. 参考代码:
import random
a = random.randint(1, 6)
b = random.randint(1, 6)
print(f"骰子1:{a} 骰子2:{b} 和:{a + b}")
2. 参考代码:
import random
names = ["小明", "小红", "小刚", "小美", "小强"]
print("今天的幸运儿是:", random.choice(names))
3. 参考代码:
import random
chars = "abcdefghijklmnopqrstuvwxyz0123456789"
password = ""
for _ in range(8):
password += random.choice(chars)
print("生成的密码:", password)
拆解: 循环 8 次,每次 random.choice(chars) 随机取一个字符,用 + 拼到 password 上。跑一次一个样——这就是"随机"的威力。
4. 参考代码:
calculator.py:
def add(a, b):
return a + b
def sub(a, b):
return a - b
def mul(a, b):
return a * b
def div(a, b):
return a / b
if __name__ == "__main__":
print(add(1, 2))
main.py:
import calculator
a = float(input("请输入第一个数:"))
b = float(input("请输入第二个数:"))
op = input("请输入运算符(+ - * /):")
if op == "+":
print(calculator.add(a, b))
elif op == "-":
print(calculator.sub(a, b))
elif op == "*":
print(calculator.mul(a, b))
elif op == "/":
try:
print(calculator.div(a, b))
except ZeroDivisionError:
print("除数不能是 0!")
else:
print("不认识这个运算符!")
拆解: calculator.py 里四个纯函数(不写输入输出,只管算),测试代码挂进 __main__ 保护;main.py 负责读输入、做分支、兜异常。模块负责"算",主文件负责"交互"——分工清楚,这就是模块化。
🐍"皮皮注:到这里你已经学会'借轮子'和'造轮子'了。下一章,把学过的函数、文件、异常、模块全揉在一起,做一个真正的项目——学生成绩管理系统!"
📖 下一章,综合项目一:学生成绩管理系统。