第 29 章 工具箱巡礼:os / datetime / json 实战
📖 本章目标:学会 os、datetime、json 三个高频标准库,直接上手干活。
学完本章,你能批量改文件名、算日期倒计时、读写配置文件——全是日常开发的硬需求。
三个库都不难,难的是"什么时候想起用它们"。今天一次认全。
【开场小剧场】老板的三个需求
学生: 皮皮,老板给我派活:① 把 100 个照片文件名统一改格式;② 做一个"距离新年还有几天"的页面;③ 把程序的设置保存下来,下次打开还记得。这三个都得自己造轮子?
皮皮: 全都不用!Python 官方给你配了三个现成的工具箱,今天一次领齐:
- os:操作系统(文件、路径、目录);
- datetime:时间日期;
- json:数据存取。
学生: 官方都配好了?那我搬砖岂不是更快了!
皮皮: 这就是为什么说"人生苦短,我用 Python"。记住它们的口诀:os 管文件,datetime 管时间,json 管数据。 遇到对应需求,直接去工具箱里翻。
29.1 os:和操作系统打交道
os 模块管"文件和目录"这类操作系统的事。最常用的几个:
import os
print(os.getcwd()) # 当前工作目录(在哪个文件夹)
print(os.listdir(".")) # 当前目录下的所有文件/文件夹名字
print(os.path.exists("README.md")) # 这个文件/路径存不存在 → True/False
print(os.path.join("a", "b", "c.py")) # 拼接路径 → a\b\c.py(自动处理斜杠)
逐行拆解:
- os.getcwd():get Current Working Directory——程序现在"站在哪个文件夹";
- os.listdir("."):列出该文件夹下的所有条目(文件+文件夹名),返回一个列表;
- os.path.exists(...):判断路径是否存在,返回 True/False——写文件前先检查,是防翻车的黄金习惯;
- os.path.join("a", "b", "c.py"):拼接路径。
os.path.join 特别重要: Windows 用 \,Mac/Linux 用 /。手工拼字符串 "a/b/c.py" 换个系统就错,用 join 自动适配,一次写好处处跑。
增删改文件:
os.rename("旧名.txt", "新名.txt") # 重命名
os.remove("不要了.txt") # 删除文件
os.mkdir("new_folder") # 新建文件夹
换例加深:拆路径的"小刀"
print(os.path.splitext("photo.jpg")) # ('photo', '.jpg') 名字和扩展名分开
print(os.path.basename("a/b/c.py")) # 'c.py' 只要最后一段
print(os.path.dirname("a/b/c.py")) # 'a/b' 只要目录部分
splitext 和 basename 是批处理时的高频小工具:改扩展名、取文件名,靠它俩几行搞定。
🐍"皮皮注:
os.remove删文件不可恢复,用之前一定确认文件名没拼错。真不小心删了,神仙也难救。"
29.2 实战:批量重命名文件
场景:文件夹里有 photo1.jpg、photo2.jpg……想统一改成 2026_photo_01.jpg 这种格式:
import os
folder = "." # 换成你的文件夹
n = 1
for filename in os.listdir(folder):
if filename.endswith(".jpg"): # 只看 .jpg
new_name = f"2026_photo_{n:02d}.jpg" # 补零:01, 02...
os.rename(os.path.join(folder, filename),
os.path.join(folder, new_name))
print(f"{filename} → {new_name}")
n += 1
逐行拆解:
- os.listdir(folder):列出文件夹里所有名字;
- endswith(".jpg"):只挑 jpg 文件——别把文件夹、别的扩展名也改了;
- f"2026_photo_{n:02d}.jpg":{n:02d} 是 f-string 补零:1 → 01,12 → 12;
- os.rename(旧, 新):两个参数都要是完整路径,所以两侧都包了 os.path.join(folder, ...);
- n += 1:计数器递增,保证编号不重复。
要点:
- 路径都用 os.path.join 拼,避免斜杠问题;
- 先打印"旧名 → 新名"再改名——批量操作一定要先看清单,确认无误再动手(真改错了是几百个文件的事)。
换例加深:加个"预览模式"防翻车
import os
folder = "photos"
n = 1
for filename in os.listdir(folder):
if filename.endswith(".jpg"):
new_name = f"2026_photo_{n:02d}.jpg"
print(f"{filename} → {new_name}") # 先只打印,不真改
n += 1
先跑一遍"只打印不执行",看输出对不对;对再删掉注释真改。 这是批量操作的标准安全流程,专业程序员都这么干。
配套代码文件:code/ch29/rename_files.py。
💡 安全三问 批量改动前先问自己:① 过滤条件对不对(会误伤吗)?② 新名字对不对(会重名覆盖吗)?③ 要不要先预览(只打印不执行)?
29.3 datetime:时间日期专家
datetime 模块管"今天是几号、几点了":
from datetime import datetime, timedelta
now = datetime.now() # 当前时间
print(now) # 2026-08-10 14:30:00.123456
print(now.year, now.month, now.day) # 2026 8 10
print(now.hour, now.minute) # 14 30
逐行拆解:
- datetime.now():取"此刻",得到的是一个 datetime 对象;
- now.year / now.month / now.day:像访问字典属性一样,拿到年、月、日;
- print(now):datetime 对象默认就能友好打印。
格式化成字符串:strftime
| 代码 | 含义 |
|---|---|
%Y |
四位年份(2026) |
%m |
两位月份(08) |
%d |
两位日期(10) |
%H |
24 小时制(14) |
%M |
分钟(30) |
%S |
秒(45) |
print(now.strftime("%Y-%m-%d")) # 2026-08-10
print(now.strftime("%Y年%m月%d日 %H:%M")) # 2026年08月10日 14:30
时间差:timedelta
from datetime import datetime, timedelta
today = datetime.now()
tomorrow = today + timedelta(days=1) # 加一天
print(tomorrow.strftime("%Y-%m-%d"))
# 两个日期相减,得到时间差
new_year = datetime(2027, 1, 1)
diff = new_year - today
print(diff.days) # 距离新年还有多少天
逐行拆解:
- today + timedelta(days=1):datetime 加一个 timedelta,得到"明天"——+ 和 - 都能用;
- datetime(2027, 1, 1):直接构造一个指定的时间点;
- new_year - today:两个 datetime 相减,得到一个 timedelta;
- diff.days:取"差了多少天"。
timedelta 里的单位:days、hours、minutes、seconds。两个 datetime 直接相减,得到一个 timedelta,取 .days 就是差几天。
换例加深:加减一起上
one_week_ago = today - timedelta(weeks=1) # 一周前
print(one_week_ago.strftime("%Y-%m-%d"))
print(today + timedelta(hours=3, minutes=30)) # 三个半小时后
timedelta 支持 weeks、days、hours、minutes、seconds,还能一次加多个。 时间计算无非"加加减减"。
🐍"皮皮注:时间一进程序就全是数字和对象,别手痒去拼字符串。'取年月日'交给
.year/.month, '格式化'交给strftime。自己拼串必乱。"
29.4 实战:日期倒计时
from datetime import datetime
def countdown(target_date, name):
"""距离目标日期还有多少天"""
today = datetime.now()
target = datetime.strptime(target_date, "%Y-%m-%d") # 字符串 → datetime
diff = target - today
days = diff.days
if days >= 0:
print(f"距离{name}还有 {days} 天")
else:
print(f"{name}已经过去 {-days} 天了")
countdown("2027-01-01", "新年") # 距离新年还有 N 天
countdown("2026-08-01", "开学") # 开学已经过去 N 天了
逐行拆解:
- datetime.strptime(target_date, "%Y-%m-%d"):把字符串"2027-01-01"解析成 datetime 对象;
- target - today:两个 datetime 相减得 timedelta;
- diff.days:得到"还差几天"(可能是负数,说明已过);
- if days >= 0:正负分开提示;负数用 -days 转成正数说"过去几天"。
strptime(注意字母顺序 P-T)和 strftime(F-T)是反着的:
- strftime:datetime 变字符串(format time);
- strptime:字符串 变 datetime(parse time)。
换例加深:strftime / strptime 对照
now = datetime.now()
s = now.strftime("%Y-%m-%d") # datetime → 字符串
print(s) # '2026-08-10'
d = datetime.strptime(s, "%Y-%m-%d") # 字符串 → datetime(转回来了)
print(d) # 2026-08-10 00:00:00
这俩是"互相翻译"的关系:一个把时间说成人话,一个把人话翻译成时间。 记不住就对着上面这段抄,抄几遍就刻进肌肉记忆了。
配套代码文件:code/ch29/countdown.py。
💡 记忆口诀:
strf= 把时间"翻"成字符串(F for Format);strp= 把字符串"拆"成时间(P for Parse)。
29.5 json:数据存取(复习 + 升级)
第 22 章已经见过 json.dump/load。这里做个完整版"配置文件"示例:
import json
config = {
"username": "皮皮",
"theme": "dark",
"volume": 80,
}
# 存:字典 → JSON 文件
with open("config.json", "w", encoding="utf-8") as f:
json.dump(config, f, ensure_ascii=False, indent=2)
# 取:JSON 文件 → 字典
with open("config.json", "r", encoding="utf-8") as f:
data = json.load(f)
print(data["theme"]) # dark
print(data["volume"]) # 80
逐行拆解:
- json.dump(字典, 文件对象, ...):把字典写进文件;
- ensure_ascii=False:中文正常保存,否则会变成 \uXXXX 一堆乱码;
- indent=2:美化格式,文件里缩进 2 格,人类能直接读;
- json.load(文件对象):把 JSON 文件读回成字典;
- data["theme"]:读回来就是个字典,直接用中括号取值。
为什么"程序记得设置"靠 JSON? 因为 JSON 是纯文本、通用、人类可读——程序关掉再开,json.load 把上次存的东西读回来,设置就"记得"了。
换例加深:字符串版的 dumps / loads
import json
# dumps:字典 → 字符串
s = json.dumps({"name": "皮皮"}, ensure_ascii=False)
print(s) # {"name": "皮皮"}
# loads:字符串 → 字典
d = json.loads(s)
print(d["name"]) # 皮皮
dump/dumps、load/loads 的区别:带 s 的操作的是字符串,不带的操作的是文件。 网络传输、拼接数据用带 s 的,持久化到文件用不带 s 的。
加载时防止文件不存在(第 20 章异常兜底):
import json
def load_config():
try:
with open("config.json", "r", encoding="utf-8") as f:
return json.load(f)
except FileNotFoundError:
return {} # 第一次运行,没有配置,用默认
config = load_config()
FileNotFoundError 兜底:第一次运行没有配置文件,返回空字典当默认。 这是"配置文件"的标准写法——每次都健壮,绝不裸奔。
配套代码文件:code/ch29/json_store.py。
🐍"皮皮注:json 就是字典的'可持久化版本'——字典在内存里,一关程序就没了;写成 json 文件,下次打开还在。你的所有设置、存档、成绩单,都靠它保命。"
【皮皮小课堂】本章要点
- os:
getcwd(当前目录)、listdir(列目录)、path.exists(存在吗)、path.join(拼路径)、rename(重命名)、remove(删除)、mkdir(建文件夹)。 os.path.join:跨平台拼路径,别手工拼/或\。- datetime:
now()(当前)、strftime(datetime→字符串)、strptime(字符串→datetime)、timedelta(时间差)。 - strftime 常用:
%Y %m %d %H %M %S。 - strftime vs strptime:strf=翻成字符串,strp=拆成时间。
- json:
dump(存)、load(取)、dumps/loads(字符串版)、ensure_ascii=False(保中文)、indent=2(美化);文件不存在用 try 兜底。 - 组合拳:
os管文件、datetime管时间、json管数据,三个库一起用,能做出很实用的工具。 - 安全习惯:批量改名先预览;删除前先确认;读文件先 try。
【翻车现场】本章的坑
坑 1:手写路径,跨系统就崩
with open("data\\files\\config.json") as f: # ❌ Windows 专属
换到 Mac/Linux,\\ 就错了。用 os.path.join("data", "files", "config.json"),自动适配当前系统。
坑 2:os.remove 误删
os.remove(input("要删的文件:")) # ❌ 输错一个字,文件没了
删除不可逆。删前先打印"即将删除:xxx",让用户确认;或者先 path.exists 检查一遍。
坑 3:strftime 和 strptime 记反
datetime.strptime(now, "%Y-%m-%d") # ❌ 把 datetime 当字符串喂给 strptime
datetime.strftime(now, "%Y-%m-%d") # ✅ datetime → 字符串
记口诀:strf = 把时间"翻"成字符串(F for Format);strp = 把字符串"拆"成时间(P for Parse)。
坑 4:json.load 文件不存在 / 内容坏了
json.load(open("config.json")) # 第一次运行,文件不存在 → FileNotFoundError
读取都用 try 兜底(见 29.5),别裸奔。
坑 5:timedelta 用错单位
today + timedelta(1) # 意思:加 1 天(day 是默认单位)
today + timedelta(hours=1) # 加 1 小时
today + timedelta(days=1, hours=2) # 同时加
timedelta 的默认单位是天。想加小时/分钟,要么用 hours=1 这种关键字参数(推荐),要么明白默认单位。写 timedelta(1) 的人十有八九是想加 1 小时,结果加了 1 天。
坑 6:json 忘写 ensure_ascii,中文变乱码
import json
config = {"username": "皮皮"}
with open("config.json", "w") as f: # ❌ 忘了 encoding 和 ensure_ascii
json.dump(config, f)
# config.json 里变成了:
# {"username": "皮皮"} ← 看着像乱码!
不写 ensure_ascii=False,中文会被存成 \uXXXX 转义序列——能用,但不可读,换个人接手就想砸键盘。正确姿势:
with open("config.json", "w", encoding="utf-8") as f:
json.dump(config, f, ensure_ascii=False, indent=2)
读写都带 encoding="utf-8",写还带 ensure_ascii=False, indent=2——三件套记牢,中文 json 再也不花。
【本章习题】
一、选择题
1. (★) 想跨平台拼接路径,应该用?
- A.
"a" + "/" + "b" - B.
os.path.join("a", "b") - C.
"a\\b" - D.
path.add("a", "b")
2. (★★) datetime.now().strftime("%Y-%m-%d") 会输出什么?
- A.
2026-8-10(不补零) - B.
2026-08-10(补零) - C.
20260810 - D. 报错
3. (★★) strptime 的作用是?
- A. 把 datetime 转成字符串
- B. 把字符串解析成 datetime
- C. 计算时间差
- D. 获取当前时间
4. (★★ 多选) 关于三个库,下列说法正确的是?
- A.
os.path.join能避免跨平台斜杠问题 - B.
json.dump(..., ensure_ascii=False)能让中文正常显示 - C.
os.remove删除文件后不可恢复 - D.
timedelta(days=1)表示加 1 天
5. (★★ 多选) 关于 json 的 dump/load,dumps/loads,正确的是?
- A.
json.dump(字典, 文件对象)把字典写入文件 - B.
json.load(文件对象)把文件读成字典 - C.
json.dumps(字典)返回一个 JSON 字符串 - D.
json.loads(字符串)把 JSON 字符串转成字典
二、判断题
1. (★) os.listdir(".") 返回当前目录下所有文件名和文件夹名。( )
2. (★★) strftime 是把字符串变成 datetime。( )
3. (★★) 两个 datetime 直接相减,会得到一个 timedelta,可以用 .days 拿天数。( )
4. (★★) json.dump(config, f, ensure_ascii=False) 能把字典里的中文正常写进文件。( )
三、代码纠错题
1. (★★) 下面的代码想列出某文件夹里所有的 .png 图片,但 png 文件没被列出来,请改正:
import os
folder = "photos"
for name in os.listdir(folder):
if name == ".png": # 这样写对吗?
print(name)
2. (★★) 下面的代码想把字符串 "2026-08-10" 转成 datetime 并加一天,但一运行就报错,请改正:
from datetime import datetime, timedelta
d = datetime.strftime("2026-08-10", "%Y-%m-%d") # ❌ 报错
print(d + timedelta(days=1))
四、编程实战题
1. (基础 ★) 写代码打印当前时间,格式为 2026年08月10日 14时30分。
2. (基础 ★★) 写一个函数 days_until(date_str),接收 "2026-12-25" 这种字符串,打印"距离 2026-12-25 还有 N 天"。
3. (基础 ★★) 用 os 模块列出当前目录下所有 .py 文件,并打印文件数量。
4. (挑战 ★★★) 写一个"日志记录器":每次运行时,把一条带时间戳的记录追加写入 log.txt(如 2026-08-10 14:30:00 程序启动)。要求:用 datetime 生成时间戳,用 with 追加写,用 strftime 格式化。
【参考答案与解析】
一、选择题
1. 答案:B
os.path.join 自动处理当前系统的斜杠,跨平台无忧。
2. 答案:B
%m、%d 默认补零成两位:08、10。
3. 答案:B
strptime = parse time,字符串 → datetime;反着的是 strftime。
4. 答案:A、B、C、D
A 对:跨平台;B 对:保中文;C 对:删除不可逆;D 对:days=1 加 1 天。
5. 答案:A、B、C、D
A 对:dump 写入文件;B 对:load 读回字典;C 对:dumps 返回字符串;D 对:loads 解析字符串。记忆:带 s 的是字符串,不带 s 的是文件。
二、判断题
1. 正确(√)。listdir(".") 列出当前目录所有条目。
2. 错误(×)。strftime 是 datetime → 字符串;字符串 → datetime 的是 strptime。
3. 正确(√)。两个 datetime 相减得 timedelta,.days 取天数。
4. 正确(√)。ensure_ascii=False 让中文以原文写入,不变成 \uXXXX。
三、代码纠错题
1. 解析: name == ".png" 判断的是名字恰好等于 ".png",而不是"以 .png 结尾"。改正:用 endswith:
import os
folder = "photos"
for name in os.listdir(folder):
if name.endswith(".png"):
print(name)
2. 解析: 用反了函数——strftime 是 datetime→字符串,这里想把字符串→datetime,该用 strptime,而且参数顺序也不同:
from datetime import datetime, timedelta
d = datetime.strptime("2026-08-10", "%Y-%m-%d") # 字符串 → datetime
print(d + timedelta(days=1)) # 2026-08-11 00:00:00
核心: strptime(字符串, 格式) 把字符串解析成时间;strftime(时间, 格式) 把时间格式化成字符串。谁带谁别搞反。
四、编程实战题
1. 参考代码:
from datetime import datetime
now = datetime.now()
print(now.strftime("%Y年%m月%d日 %H时%M分"))
# 例如:2026年08月10日 14时30分
2. 参考代码:
from datetime import datetime
def days_until(date_str):
target = datetime.strptime(date_str, "%Y-%m-%d")
diff = target - datetime.now()
if diff.days >= 0:
print(f"距离 {date_str} 还有 {diff.days} 天")
else:
print(f"{date_str} 已经过去 {-diff.days} 天了")
days_until("2026-12-25")
3. 参考代码:
import os
py_files = [name for name in os.listdir(".") if name.endswith(".py")]
print(f"当前目录有 {len(py_files)} 个 .py 文件:")
for name in py_files:
print(name)
解析: 列表推导式(第 14 章)一行过滤出 .py 文件,len 数数量——os + 推导式,是列举文件的标准组合。
4. 参考代码:
from datetime import datetime
def log(message):
now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
with open("log.txt", "a", encoding="utf-8") as f:
f.write(f"{now} {message}\n")
log("程序启动")
log("用户登录")
print("已写入 log.txt,看看内容吧:")
with open("log.txt", "r", encoding="utf-8") as f:
print(f.read())
🐍"皮皮注:os 管文件、datetime 管时间、json 管数据——这套组合拳你已拿下。最后一站!毕业项目:把全书所有功夫,拧成一台真正的待办清单(Todo)机器。打完这只最终 BOSS,你就出师了!"
📖 下一章,毕业项目:命令行待办清单(To-Do)。