pathlib write_text与write_bytes详解 - Python文件写入教程

一、方法概述

Path.write_text() 和 Path.write_bytes() 是 Python pathlib 模块提供的两个便捷文件写入方法。它们将传统的 open() + write() + close() 三步操作简化为一个方法调用，使代码更加简洁优雅。

• write_text()：以文本模式写入字符串到文件

• write_bytes()：以二进制模式写入字节串到文件

重要提示：这两个方法都会覆盖已有文件内容。如果文件已存在，原有内容将被完全替换。如需追加内容，请使用 open() 的追加模式。

二、语法与参数

write_text() 语法

Path.write_text(data, encoding=None, errors=None)

write_bytes() 语法

Path.write_bytes(data)

参数详解

返回值

两个方法都返回写入的数据量：write_text() 返回写入的字符数，write_bytes() 返回写入的字节数。

三、写入文本文件

使用 write_text() 可以一行代码完成文件写入，无需手动管理文件的打开和关闭。

from pathlib import Path

# 写入文本
output = Path('output.txt')
chars = output.write_text('Hello, pathlib!\n你好！', encoding='utf-8')
print(f"写入了 {chars} 个字符")

# 读取验证
print(f"内容: {output.read_text(encoding='utf-8')}")

# 清理
output.unlink()

# 输出：
# 写入了 19 个字符
# 内容: Hello, pathlib!
# 你好！

可以看到，返回值 19 正好是写入的字符总数（包含换行符和中文字符）。

四、写入二进制文件

当需要写入二进制数据时，使用 write_bytes() 方法。这在处理图片、音频或其他二进制格式文件时非常有用。

from pathlib import Path

# 写入二进制数据
bin_file = Path('data.bin')
data = bytes(range(10))  # 0-9 的字节序列
written = bin_file.write_bytes(data)
print(f"写入了 {written} 字节")

# 读取验证
print(f"内容: {list(bin_file.read_bytes())}")

# 清理
bin_file.unlink()

# 输出：
# 写入了 10 字节
# 内容: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

五、生成报告文件实战

下面演示一个更实际的场景：根据数据字典自动生成文本报告文件。这个例子还展示了如何在写入前自动创建父目录。

from pathlib import Path

def generate_report(data, output_path):
    """生成文本报告"""
    path = Path(output_path)
    # 确保父目录存在
    path.parent.mkdir(parents=True, exist_ok=True)

    lines = ['=== 数据报告 ===', '']
    for key, value in data.items():
        lines.append(f'{key}: {value}')

    content = '\n'.join(lines)
    path.write_text(content, encoding='utf-8')
    return path

report_data = {
    '总用户数': 1500,
    '活跃用户': 890,
    '平均在线时长': '45分钟',
}

report_path = generate_report(report_data, 'reports/daily/report.txt')
print(f"报告已生成: {report_path}")
print(report_path.read_text(encoding='utf-8'))

# 清理
import shutil
shutil.rmtree('reports')

# 输出：
# 报告已生成: reports\daily\report.txt
# === 数据报告 ===
#
# 总用户数: 1500
# 活跃用户: 890
# 平均在线时长: 45分钟

这个函数非常实用：path.parent.mkdir(parents=True, exist_ok=True) 确保即使多级目录不存在也能自动创建，避免了手动检查目录的繁琐。

六、实际应用场景

• 配置文件生成：将配置信息写入 JSON、YAML 或 INI 格式文件

• 报告输出：生成文本格式的分析报告、日志摘要等

• 数据导出：将处理后的数据写入 CSV、文本等格式文件

• 临时文件创建：创建临时配置文件或缓存文件

七、注意事项与最佳实践

注意1：write_text() 和 write_bytes() 会覆盖已有文件内容。如需追加，请使用 open(path, 'a') 模式。

注意2：写入前不会自动创建父目录。如果父目录不存在，会抛出 FileNotFoundError。需先调用 mkdir(parents=True) 创建。

注意3：write_text() 默认使用系统编码，建议始终指定 encoding='utf-8'。

提示：如需追加内容，使用 with path.open('a', encoding='utf-8') as f: f.write(...) 模式。

八、方法对比表格

九、常见问题 FAQ

十、练习题