进阶修炼与毕业 · 进阶与毕业

第29章 工具箱巡礼

os / datetime / json

第 29 章 工具箱巡礼:os / datetime / json 实战

📖 本章目标:学会 os、datetime、json 三个高频标准库,直接上手干活。
学完本章,你能批量改文件名、算日期倒计时、读写配置文件——全是日常开发的硬需求。
三个库都不难,难的是"什么时候想起用它们"。今天一次认全。


【开场小剧场】老板的三个需求

学生: 皮皮,老板给我派活:① 把 100 个照片文件名统一改格式;② 做一个"距离新年还有几天"的页面;③ 把程序的设置保存下来,下次打开还记得。这三个都得自己造轮子?

皮皮: 全都不用!Python 官方给你配了三个现成的工具箱,今天一次领齐:

学生: 官方都配好了?那我搬砖岂不是更快了!

皮皮: 这就是为什么说"人生苦短,我用 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 文件,下次打开还在。你的所有设置、存档、成绩单,都靠它保命。"


【皮皮小课堂】本章要点


【翻车现场】本章的坑

坑 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. (★) 想跨平台拼接路径,应该用?

2. (★★) datetime.now().strftime("%Y-%m-%d") 会输出什么?

3. (★★) strptime 的作用是?

4. (★★ 多选) 关于三个库,下列说法正确的是?

5. (★★ 多选) 关于 json 的 dump/load,dumps/loads,正确的是?

二、判断题

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)。

📦 本章配套代码

运行方式:命令行进入目录后执行 py 文件名.py(Windows)或 python3 文件名.py(Mac/Linux)