Python文件追加案例如何续写内容

wen python案例 2026-07-01 31

Python文件追加案例：如何续写内容的完整指南

目录导读

文件追加的核心概念 – 理解追加模式与写入模式的区别
基础追加操作 – 使用open()与'a'模式
换行与格式化 – 避免内容挤在一起
批量追加数据 – 循环与列表场景
安全追加技巧 – 异常处理与文件关闭
实际案例：日志系统 – 模拟真实项目
常见问答 – 解决追加时的痛点问题

文件追加的核心概念

在Python中,向文件追加内容（即“续写”）与覆盖写入是两种不同的操作，许多初学者容易混淆'w'（写入模式）与'a'（追加模式）——前者会清空文件后从头编写，而后者会在文件末尾继续添加新内容，如果你有一个已存在的log.txt文件，用'w'模式打开后，原有数据会被删除；使用'a'模式则能保留历史记录。

Python文件追加案例如何续写内容

关键点：

'a'模式（append）：若文件不存在，自动创建；若存在，指针移至末尾。
'a+'模式：追加+可读，但写入始终在末尾。

基础追加操作

最简单的追加案例只需两行代码：

with open('example.txt', 'a', encoding='utf-8') as f:
    f.write('这是新追加的内容。')

这里with语句会自动关闭文件，无需手动f.close()，运行多次后，example.txt中会累积多行“这是新追加的内容。”——但注意，它们会连成一行。

换行与格式化

直接使用write()不会自动换行，所以我们需要手动添加换行符\n：

with open('example.txt', 'a', encoding='utf-8') as f:
    f.write('第一行内容\n')
    f.write('第二行内容\n')

若要写入多行数据或格式化字符串,可配合列表与循环：

lines = ['行1', '行2', '行3']
with open('example.txt', 'a', encoding='utf-8') as f:
    for line in lines:
        f.write(line + '\n')

注意：如果原文件最后一行已有换行符，追加时可能会出现空行，此时可以使用strip()或判断文件末位字符，但通常保持统一即可。

批量追加数据

当需要从列表、CSV或数据库中读取数据并追加到文件时，推荐使用循环或列表推导式：

data = [
    {'name': '张三', 'score': 90},
    {'name': '李四', 'score': 85}
]
with open('scores.txt', 'a', encoding='utf-8') as f:
    for item in data:
        f.write(f"{item['name']},{item['score']}\n")

若数据量很大（如数万行），可以使用writelines()方法（注意：它不会自动添加换行符）：

with open('bigdata.txt', 'a') as f:
    f.writelines([line + '\n' for line in huge_list])

安全追加技巧

以下做法能让你的追加操作更健壮：

异常处理：避免因权限或磁盘满导致程序崩溃

try:
    with open('log.txt', 'a', encoding='utf-8') as f:
        f.write('操作记录')
except IOError as e:
    print(f"写入失败：{e}")

避免重复打开文件：若在一个循环中频繁追加同一文件，请将with块置于循环外部，减少文件IO开销。
追加二进制文件：如图片或音频，使用'ab'模式
```
with open('image.bin', 'ab') as f:
    f.write(binary_data)
```
检查文件结尾：若你希望在文件中特定位置插入内容（而非末尾），需使用'r+'模式配合seek()，但这不是严格意义上的“追加”。

实际案例：日志系统

假设我们构建一个简单的日志记录器,每次运行程序时记录时间戳与消息：

import datetime
def append_log(file_path, message):
    timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    log_line = f"[{timestamp}] {message}\n"
    try:
        with open(file_path, 'a', encoding='utf-8') as f:
            f.write(log_line)
    except Exception as e:
        print(f"日志写入失败: {e}")
# 使用示例
append_log('app.log', '程序启动')
append_log('app.log', '用户登录成功')

运行后,app.log内容类似：

[2025-04-10 14:23:01] 程序启动
[2025-04-10 14:23:05] 用户登录成功

此案例常用于监控、审计或错误追踪场景。

常见问答

问：为什么我用'a'模式追加后，新内容跑到文件开头去了？
答：可能是你之前以'r+'或'w+'模式操作时移动了文件指针。'a'模式始终从末尾写入，但若文件被其他程序锁定或缓冲区未刷新，可能产生错觉，检查代码中是否有其他模式混用。

问：如何避免每次追加都产生一个空行？
答：确保你写入时始终在字符串末尾添加\n，并检查原文件末尾是否已有一个换行符，如果原文件结尾没有换行，追加后第一行会紧跟最后一行，解决方法是：先判断文件是否存在且不为空，若末尾没有换行，先写入一个\n再追加，或者保持统一约定，文件每行都以换行结尾。

问：追加模式能用于非常大的文件吗？
答：完全可以。'a'模式不会将整个文件加载到内存，它只定位到末尾并写入，对于GB级别的日志文件，Python依然能高效操作，但需注意操作系统对单个文件大小的限制。

问：write()与writelines()哪个更快？
答：在批量写入小片段时，writelines()在一次系统调用中写入多个字符串（但需自行添加换行符），通常比循环调用write()快，但差异仅在百万级数据时显著，日常使用中，可优先选择可读性更好的循环方式。

问：追加内容后，其他程序能立即看到变化吗？
答：由于操作系统和硬盘缓冲，数据可能滞后写入磁盘，使用with块关闭文件后，其他程序通常能立即看到（取决于文件系统中的刷新策略），若需强制同步，可调用f.flush()并确保文件未被其他进程独占。

本文总结了Python文件追加的完整实践：从基础语法到安全技巧，再到日志案例，掌握'a'与'a+'模式的正确使用，能帮助你高效处理需要持续记录或积累数据的场景（如日志、交易记录、用户活动追踪），慎用'w'避免数据覆盖，善用异常处理保障稳定性，合理添加换行符保持文件可读性，如果你有任何追加操作中的特殊需求（如按特定格式追加、跨平台换行符处理），欢迎在实践中继续探索。