深色模式
第 18 章:常用标准库/模块
本章在知识链中的位置:第 4 章解释了
import这一行在做什么,第 9 章用过字符串方法,第 10 章用过列表,第 15 章用过文件读写。本章把"import 后面的名字"系统整理一遍——它们都来自同一个地方:标准库。
本章能学到什么
- 什么是标准库,为什么语言要自带一个"工具箱"
math、random、datetime、os、json、collections等常用模块各自解决什么问题- 三个完整可运行的小程序:随机抽学号、日期计算、字母统计与存档
- Python 标准库与 C++ 标准库在设计上的差异(对照阅读)
从一个熟悉的场景说起
开学发新书的时候,书包里除了课本,还有一整套文具:铅笔、橡皮、尺子、圆规、计算器。做数学作业时不需要自己造一把尺子——伸手从文具盒里拿就行。
写程序也一样。排序、开平方、生成随机数、读取当前日期,这些是几乎所有程序都会用到的"文具"。如果每个功能都要程序员从零写一遍,那写任何程序之前都得先造一遍尺子。所以 Python 的设计者把这些常用功能提前写好、反复测试,打包随语言一起发布,这就是标准库。
数学课本的附录里有一张"公式表",考试不考背公式,考的是知道什么时候查哪一行。标准库在编程里的位置,和这张公式表在数学里的位置一样:重要的不是背下来,而是知道它存在、知道去哪里查。
第 4 章讲过:源文件里的 import math,意思是"把 math 这个工具箱拿到手边"。math 只是标准库几百个模块中的一个。本章把最常用的几个摆到桌面上。
先建立两个整体印象,再看细节。
印象一:标准库是"语言的一部分",不是外挂。 安装 Python 的时候,它就一起装好了,不用额外下载任何东西。能直接 import 的模块,都是随语言自带的。
印象二:标准库里的代码是千锤百炼的。 一个 sorted 背后是经过多年优化的排序算法,比自己随手写的排序又快又稳、又少出错。能用现成工具的时候,优先用现成工具——这不是偷懒,是专业做法,也是全行业的共识。
标准库速查表
| 模块 | 能解决什么 | 一个例子 |
|---|---|---|
math | 数学计算:开方、乘方、取整、三角函数 | math.sqrt(25) 结果是 5.0 |
random | 随机数、随机抽取、洗牌 | random.randint(1, 40) |
datetime | 日期与时间:今天几号、两个日期差几天 | date.today() |
os | 文件与文件夹操作:列目录、改名字 | os.listdir() |
json | 把字典、列表存成通用格式的文本 | json.dumps(d) |
collections | 增强版容器:计数器、双端队列 | Counter("hello") |
time | 计时、暂停 | time.sleep(1) |
这张表不需要背。它的用法和字典一样:遇到"不知道 Python 有没有现成功能"的时候,回来查一下。
换个角度看这张表,它其实按用途分成了四堆:数学计算(math)、随机与游戏(random)、与时间打交道(datetime、time)、与数据和文件打交道(os、json、collections)。数学课上"先分类、再查表"的整理方法,在这里同样适用——记住四堆的边界,找工具时就知道该往哪堆里伸手。
Python 官方把这份"随语言自带"的清单称为 "batteries included"(电池已附赠):买回一台玩具车,电池已经装好,开箱就能跑。这也是 Python 适合初学的原因之一——大部分想法,标准库里已经备好了零件。
示例一:随机抽学号
班会课上要随机抽一位同学回答问题。全班学号 1 到 40,用程序抽最公平。
python
import random # 随机数模块
# randint(1, 40) 生成 1~40 之间的整数,两端都包含
id = random.randint(1, 40)
print(f"本次抽到的学号是:{id}")text
本次抽到的学号是:27random 模块每次启动程序都会自动换随机种子,所以不需要像有些语言那样手动设置。上面的输出只是某一次运行的结果,每次运行抽到的学号都可能不同。
randint(1, 40) 的两个参数是"闭区间"——1 和 40 都有可能被抽到。这一点和数学里的区间记号 [1, 40] 一致,也和第 6 章见过的 range(1, 41) 形成对照:range 不含右端点,randint 两端都含。用混了是常见的"差一错误",抽学号时若写成 randint(1, 39),40 号同学就永远轮不到。
《C++ 从入门到精通》 第 18 章里有一个一模一样的程序,功能相同,输出格式完全相同,可以对照着看。
示例二:距离元旦还有多少天
想知道今天距离下一个元旦还有多少天。手算要数日历,datetime 模块里两个日期可以直接相减。
python
from datetime import date # 从 datetime 模块里只取 date 这个工具
today = date.today() # 今天的日期
target = date(2027, 1, 1) # 目标日期:2027 年元旦
days = (target - today).days # 两个日期相减,再取出相差的天数
print(f"今天是:{today}")
print(f"距离 2027 年元旦还有 {days} 天")text
今天是:2026-11-17
距离 2027 年元旦还有 45 天输出的日期和天数取决于运行程序的那一天,每次运行可能不一样。date(2027, 1, 1) 的年、月、日按日常习惯书写,不用像有些语言那样从 0 开始数月份。
两个 date 相减得到的是一个 timedelta 对象,意思是"一段时间"。它可以加减:比如 today + timedelta(days=100) 就是"100 天后是几月几号"。日期推算历来是编程里最容易算错的事情之一——大小月、闰年、跨年都要处理,交给 datetime 就不必自己操心。
示例三:字母统计与存档
英语老师想知道:一段英文里哪些字母出现得最多?collections 模块里的 Counter 专门干"数数"这件事。统计完再用 json 模块把结果存成文件,下次直接读取。
python
import json
from collections import Counter # 计数器
# 统计一句英文里每个字母出现的次数
text = "hello world hello python"
counter = Counter(text.replace(" ", "")) # 先去掉空格再统计
print("出现次数最多的 3 个字母:", counter.most_common(3))
# Counter 是一种特殊的字典,转成普通字典后存成 JSON 文件
with open("letters.json", "w", encoding="utf-8") as f:
json.dump(dict(counter), f, ensure_ascii=False, indent=2)
print("统计结果已保存到 letters.json")text
出现次数最多的 3 个字母: [('l', 5), ('o', 4), ('h', 3)]
统计结果已保存到 letters.json运行后,程序所在的文件夹里会多出一个 letters.json 文件,用记事本打开就能看到类似 {"h": 3, "e": 2, "l": 5, ...} 的内容。JSON 是一种人和程序都能看懂的通用文本格式,第 15 章的文件读写加上 json 模块,就等于有了一间"仓库":字典、列表都能整个存进去、整个取出来。
速查表之外:怎么找到更多模块
速查表只列了七个模块,标准库里还有几百个。需要某个功能时,一般的路径是:
| 步骤 | 做法 |
|---|---|
| 第一步 | 用日常语言描述需求:"Python 怎么把字符串转成大写" |
| 第二步 | 搜索,或查阅官方文档(docs.python.org 的"标准库参考") |
| 第三步 | 找到模块后,把对应的 import 写在文件开头 |
还有一个就地查看的办法:在交互式窗口里输入 import math 然后 help(math),这个模块的全部功能和说明就会列出来。help 是内置函数,对任何模块、任何函数都管用,比如 help(random.randint)。
常见疑问
问:这些功能要自己背下来吗? 不用。记住"标准库里大概有哪些类别的工具"就够了,具体写法随用随查。有经验的程序员也一样天天查文档。
问:random 生成的随机数是"真随机"吗? 不是。它是按固定公式算出来的"伪随机数",只是看起来没有规律,统计性质足够均匀。抽学号、做游戏完全够用;涉及密码和资金安全的场合,要换用 secrets 模块。
问:import random 和 from datetime import date 有什么区别? 前者把整个模块拿进来,用时写 random.randint(...);后者只取模块里的一个工具,用时直接写 date(...)。第 4 章讲过两种写法的取舍:只用到模块里的一两样东西时,点名导入更清楚。
问:标准库之外还有工具吗? 有,而且数量庞大,叫"第三方库"——比如画图用的、做数据分析用的、做网站用的。第三方库需要用 pip 命令另外安装,和"随语言自带"的标准库是两回事。入门阶段把标准库用熟,已经能解决绝大多数问题。
问:看不懂文档里的术语怎么办? 先看文档里的示例代码,示例通常比文字说明直观;示例能跑通,再回头读文字。遇到完全不认识的词,回到本书对应章节或附录查一下即可。文档是工具,不是考卷,没有谁要求一次全看懂。
对照 C++:同一个工具箱,两种管理方式
本质问题:一门语言自带的成百上千个功能,应该怎么组织,又怎么交到程序员手里?
各自做法:Python 把功能按主题分成几百个模块,import 在程序运行时才把模块加载进来,写成 random.randint(1, 40) 这样"模块名点功能名"的形式;也可以 from datetime import date,只取要用的那一个工具。C++ 把功能按主题分成几十个头文件,#include 在编译之前把说明书原样复制进源文件,编译器在编译期就检查每个名字有没有拼错、参数类型对不对。
同一个任务,两种写法放在一起看:
| 任务 | Python 写法 | C++ 写法 |
|---|---|---|
| 开平方 | math.sqrt(25) | sqrt(25)(来自 cmath) |
| 1~40 的随机整数 | random.randint(1, 40) | rand() % 40 + 1(来自 cstdlib) |
| 今天的日期 | date.today() | time + localtime(来自 ctime) |
| 排序 | sorted(列表)(内置函数) | sort(v.begin(), v.end())(来自 algorithm) |
为什么设计不一样:Python 追求"运行时灵活"——模块可以边运行边加载,可以在交互窗口里边试边用;代价是很多错误要跑到那一行才暴露。C++ 追求"编译期确定一切"——能检查的错误绝不拖到运行,用不上的功能绝不带进成品程序,换来运行速度和零多余开销;代价是头文件机制比较生硬。两种取向服务不同的使用场景,不存在谁优谁劣。
本章小结
| 关键词 | 一句话回顾 |
|---|---|
| 标准库 | 语言自带、无需安装的工具箱 |
import / from ... import | 把整个模块或单个工具拿到手边(第 4 章) |
random.randint | 闭区间内的随机整数 |
date / timedelta | 日期与"一段时间"的加减 |
Counter / json | 数数专用容器与通用存档格式 |
| 学习姿势 | 记类别、查文档,不背写法 |
动手实验
三道题从"直接套用"到"组合改造"再到"独立完成",按顺序做。每道题都只需要本章介绍的模块加上前面章节的基础语法。
数学课学过勾股定理:直角三角形两直角边为 a 和 b,斜边 c = √(a² + b²)。写一个程序,两直角边取 3 和 4,输出斜边长度。(提示:
math模块里的sqrt)把示例一的抽学号程序改成"抽奖箱":从 1~40 中连续抽 3 个不重复的学号,按从小到大输出。(提示:
random.sample专门抽不重复的样本)用
datetime写一个"生日倒计时":输入生日的月和日,输出距离今年生日还有多少天。允许只做简化版——假设今年的生日还没到。
💡 查看答案
第 1 题
python
import math
a = 3
b = 4
c = math.sqrt(a * a + b * b) # sqrt 计算平方根
print(f"斜边长度:{c}")text
斜边长度:5.0Python 的 math.sqrt 返回的是小数,所以显示 5.0;C++ 册同一道题显示 5。写法不同,表示的是同一个长度。
第 2 题
python
import random
# sample(range(1, 41), 3):从 1~40 中抽 3 个互不相同的数
picked = random.sample(range(1, 41), 3)
picked.sort() # 从小到大排列,方便查看
print(f"抽中的学号是:{' '.join(map(str, picked))}")text
抽中的学号是:7 19 33每次运行抽到的学号都可能不同。' '.join(...) 是第 9 章字符串的方法:把列表里的元素用空格连成一整串。
第 3 题(简化版)
python
from datetime import date
month = int(input("生日是几月?"))
day = int(input("生日是几日?"))
today = date.today()
birthday = date(today.year, month, day) # 简化:假设是今年
days = (birthday - today).days
print(f"距离今年生日还有 {days} 天")输出的天数因运行日期不同而不同。进阶版需要判断"今年生日是否已过、过了就按明年算",用第 5 章的条件判断即可完成。
