使用 write() 和 writelines() 写入文本文件

原创于 2025-08-08 00:45:00 发布 · 1.7k 阅读

29 ·

CC 4.0 BY-SA版权

文章标签：

#智能化测试 #AI赋能 #开发语言 #python #零基础学Python #软件开发和测试 #人工智能

测试开发和测试同时被 3 个专栏收录

421 篇文章

订阅专栏

人工智能

348 篇文章

订阅专栏

零基础学Python

142 篇文章

订阅专栏

在软件开发过程中，文件写入操作是数据持久化的重要手段，广泛应用于日志记录、配置保存、数据导出等场景。Python作为一门优雅且功能强大的编程语言，提供了多种灵活便捷的文件写入接口，其中write()和writelines()是两个核心方法。深入理解它们的设计理念、使用区别及最佳实践，不仅能提高程序的性能和健壮性，还能优化代码的可读性和维护性。本文将系统解析write()与writelines()的工作机制、典型应用及实用技巧，帮助读者在日常开发中写出更高效、优雅的文件写入代码。

一、Python文件写入基础回顾

在Python中，写入文件通常通过内置的open()函数打开文件并获得文件对象，继而调用写入方法。常用打开模式包括：

'w'：写入模式（覆盖文件内容）
'a'：追加模式（内容追加到文件末尾）
'x'：独占创建模式（文件不存在时创建，存在则报错）

示例：

with open('output.txt', 'w', encoding='utf-8') as f:
    # 调用写入方法

二、`write()`方法详解

1. 功能与用法

write(string)将字符串string写入文件，返回写入字符数。
需要手动管理换行符，否则文本连续写入。

2. 代码示例

with open('output.txt', 'w', encoding='utf-8') as f:
    count = f.write("Hello, World!\n")
    print(f"写入了{count}个字符")

3. 适用场景

写入单个字符串或小段文本；
需要精确控制写入顺序和内容；
处理交互式或动态内容时。

4. 注意点

write()不自动添加换行符，需显式添加\n；
写入非字符串时需转换类型。

三、`writelines()`方法详解

1. 功能与用法

writelines(lines)接受一个可迭代对象（如列表、生成器），将所有元素逐个写入文件。
不添加任何分隔符或换行符，元素需自行携带换行符。

2. 代码示例

lines = ["第一行\n", "第二行\n", "第三行\n"]

with open('output.txt', 'w', encoding='utf-8') as f:
    f.writelines(lines)

3. 适用场景

一次写入多行文本；
文件内容已按行组织，需高效批量写入；
结合生成器、列表推导快速构造写入内容。

4. 注意点

writelines()不返回写入长度或状态；
行尾换行符需保证，否则写入结果会连成一行。

四、`write()`与`writelines()`对比分析

特性	`write()`	`writelines()`
输入类型	单个字符串	可迭代的字符串序列
自动换行	否，需要手动添加	否，需元素自行包含换行符
返回值	写入字符数	无返回值
适合写入场景	单条字符串写入	多行批量写入
性能	逐次调用开销较大	一次调用写入所有内容，效率更高

五、实战应用示例

1. 使用`write()`写入动态内容

with open('log.txt', 'a', encoding='utf-8') as f:
    for i in range(5):
        f.write(f"日志条目{i+1}\n")

2. 使用`writelines()`写入已有行列表

lines = [f"日志条目{i+1}\n" for i in range(5)]
with open('log.txt', 'w', encoding='utf-8') as f:
    f.writelines(lines)

六、性能与优化建议

批量写入优先使用writelines()，减少系统调用次数，提升I/O效率；
避免在循环中频繁调用write()，特别是在大数据写入场景下；
使用生成器表达式延迟生成写入内容，结合writelines()实现高效流式写入，节省内存：

def generate_lines():
    for i in range(1000000):
        yield f"数据行{i}\n"

with open('large_output.txt', 'w', encoding='utf-8') as f:
    f.writelines(generate_lines())