Python 教程 / 用 pathlib 处理文件与目录路径

pathlib.Path 是按操作系统规则组合和检查文件路径的对象。相对路径以当前工作目录为起点,不会自动以脚本所在目录为起点;先明确这个区别,才能避免把输出文件写到意外位置。

用路径对象组合位置

Path("data") / "expenses.csv"使用除号运算符连接路径组成部分,减少手写 Windows 反斜杠和按系统选择分隔符的需要。创建 Path 对象只是表达位置,不会因此新建文件或文件夹。

Path.cwd()返回当前工作目录。在普通脚本中,Path(__file__).resolve().parent可用于取得脚本所在目录;某些交互环境没有 __file__。程序应明确选择基准目录,而不是假设两者总相同。相应方法见Python 官方 pathlib 文档。

下面练习使用当前工作目录下的 lab-data。请建立新的独立练习目录:程序会写入 lab-data/expenses.csv,如果该文件已经存在,其内容会被替换。不要在保存真实账本的目录直接运行。

创建并检查练习 CSV

将以下完整代码以 UTF-8 保存为 paths.py。在该练习目录打开终端,使用项目虚拟环境执行 python paths.py;若你核对过的解释器命令是 python3,就相应使用 python3 paths.py。本例只使用标准库:

from pathlib import Path

base = Path("lab-data")
base.mkdir(exist_ok=True)
path = base / "expenses.csv"
path.write_text("name,amount\nlunch,8000\n", encoding="utf-8")
print(path.name, path.suffix, path.stem)
print(path.is_file(), base.is_dir())
print(sorted(p.name for p in base.glob("*.csv")))

在全新的练习目录中,预期输出为:

expenses.csv .csv expenses
True True
['expenses.csv']

mkdir(exist_ok=True)允许目标目录已存在,不等于可以忽略权限错误或同名位置其实是文件的情况。这里没有使用 parents=True,所以若你改为多层目录,还要确保父目录已存在,或按需要显式创建父目录。

name 是完整文件名 expenses.csv,suffix 是最后一个后缀 .csv,stem 是去掉最后后缀后的 expenses。is_file 与 is_dir 分别核对文件和目录;glob 查找结果经 sorted 排序后显示文件名。

打开生成的 CSV,应看到表头 name,amount和数据行 lunch,8000。它们表示名称与金额,不是两个额外 Python 语句。若练习目录原先已有其他 .csv 项目,最后一行列表会包含它们,所以首次比较应使用新的目录。

理解搜索与存在检查的限制

glob("*.csv")搜索当前指定目录,rglob("*.csv")还会搜索子目录。匹配结果可能包括名称也以 .csv 结尾的目录;如果只要文件,应加上 is_file() 条件。不要依赖未经排序的搜索顺序来产生固定报告。

exists() 检查与后续读取或写入之间,路径可能被另一个程序修改。存在检查有助于提示,却不能消除权限、竞争或磁盘错误。重要文件操作还要明确覆盖规则并处理异常;Path 对象本身不是安全沙箱。

如果从其他目录运行 python C:/work/demo/paths.py,本例的 lab-data 会出现在那个工作目录下。若需求是放在源码旁,可将 base 改为 Path(__file__).resolve().parent / "lab-data"。这代表改变路径约定,不是任何程序都必须采取的修复。

在运行写入代码之前,先用不写文件的命令 python -c "from pathlib import Path; print((Path.cwd() / 'lab-data' / 'expenses.csv').resolve())"确认当前约定的绝对目标。按脚本位置计算的方案,则应核对脚本的实际完整路径。

比较位置、文件名并限制操作范围

  1. 先打开新建 CSV,确认表头、金额与文件位置,再只将代码中的 expenses.csv 改为 report.txt。重新运行后,name、suffix、stem 应变为 report.txt、.txt、report;原 CSV 不会因此自动改名或删除。
  2. 恢复文件名,在另一个新建的练习目录中按完整脚本路径运行同一文件。应在新的工作目录下出现另一份 lab-data;比较两份数据的位置,而不是只看终端打印相同就认定写入同一文件。
  3. 清理时先确认每个目标的解析后绝对路径,仅删除本次创建且已确认可丢弃的练习文件。不要依据短文件名或未检查的变量递归删除整个目录。

外部输入还可能包含 ../、绝对路径或符号链接。用字符串 startswith 比较前缀,可能把同前缀的相邻目录误认为允许目录。应按程序的路径约定解析并比较真实路径关系,同时考虑链接和检查后路径被更改的情况;不能把一次前缀检查当成完整访问控制。