Python 将字符串写入文件的正确姿势

使用 with open() 可安全写入字符串,需指定 encoding='utf-8' 防止乱码,选 'w' 覆盖、'a' 追加、'x' 防覆盖,多行用 writelines() 并手动加 \n,避免不关文件和路径错误。

在 Python 中将字符串写入文件看似简单,但用对方法才能避免常见问题,比如编码错误、资源未释放或内容被覆盖。关键是选择合适的方式并遵循最佳实践。

使用 with open() 确保安全写入

推荐始终使用 with open() 语句操作文件。它能自动关闭文件,即使写入过程中出错也能保证资源释放。

示例:

text = "Hello, Python世界!"
with open('output.txt', 'w', encoding='utf-8') as f:
f.write(text)

这里指定了 encoding='utf-8',防止中文等非 ASCII 字符出现乱码。

理解文件打开模式

写入方式不同,结果也不同。常用模式有:

  • 'w':写入模式,会清空原文件内容。适合新建或覆盖文件
  • 'a':追加模式,新内容加在文件末尾。适合日志记录
  • 'x':独占创建模式,文件存在时写入失败,防止误覆盖
追加写入示例:

with open('log.txt', 'a', encoding='utf-8') as f:
f.write("新的日志条目\n")

处理多行字符串

如果要写入多行内容,可以使用 writelines() 或循环写入。

lines = ["第一行\n", "第二行\n", "第三行\n"]
with open('multi.txt', 'w', encoding='utf-8') as f:
f.writelines(lines)

注意:writelines 不自动添加换行符,需手动在每行末尾加上 \n。

避免常见坑

几个关键点帮你避开陷阱:

  • 不指定 encoding 在不同系统上可能出错,尤其是 Windows
  • 不用 with 可能导致文件句柄泄露,程序跑久了会出问题
  • 路径不存在时会报错,必要时先创建目录
确保目录存在的小技巧:

import os
os.makedirs(os.path.dirname('data/output.txt'), exist_ok=True)
with open('data/output.txt', 'w', encoding='utf-8') as f:
f.write("保存到深层路径")

基本上就这些。只要记得用 with、设编码、选对模式,写字符串进文件就很稳。