Python文件操作入门：轻松创建、写入与管理TXT文本文件113

大家好！我是你们的中文知识博主。在编程的世界里，数据存储是基石之一。无论是记录日志、保存用户配置，还是处理报告，文件操作都是我们日常开发中不可或缺的技能。今天，我们要深入探讨的是Python编程语言中一个最基础也最常用的文件操作——如何创建、写入和管理TXT文本文件。

Python以其简洁优雅的语法，使得文件操作变得异常直观。即使是编程新手，也能很快上手。那么，准备好了吗？让我们一起开启这段文件操作的探索之旅吧！

理解文件操作的核心：`open()` 函数

在Python中，所有文件操作都始于一个核心函数：`open()`。它就像一道门，帮你打开（或创建）文件，然后你可以通过这扇门进行读写。`open()` 函数的基本语法如下：open(file, mode='r', encoding=None)

`file`: 这是你想要操作的文件路径和文件名。可以是相对路径（相对于当前运行脚本的位置），也可以是绝对路径。
`mode`: 这是文件打开模式，非常关键！它决定了你打开文件后能做什么。我们一会儿会详细介绍。
`encoding`: 这是文件的编码方式。对于中文内容，强烈建议指定为 `'utf-8'`，以避免出现恼人的乱码问题。

文件打开模式（`mode`）详解：

`mode` 参数就像你打开文件时选择的“工具”，不同的工具对应不同的操作权限。对于创建和写入TXT文件，有几个模式是我们需要重点掌握的：
`'w'` (write): 写入模式。

如果文件不存在，则会创建一个新文件。
如果文件已存在，则会清空文件中的所有内容，然后从头开始写入。
这是最常用的创建和覆盖文件内容的方式。

`'a'` (append): 追加模式。

如果文件不存在，则会创建一个新文件。
如果文件已存在，则会在文件末尾添加新内容，而不会覆盖原有内容。
非常适合用于记录日志或追加数据。

`'x'` (exclusive creation): 独占创建模式。

如果文件不存在，则会创建一个新文件并打开以供写入。
如果文件已存在，则会触发 `FileExistsError` 错误。
这个模式可以确保你创建的是一个全新的文件，避免意外覆盖。

`'r'` (read): 读取模式。

这是默认模式，如果未指定 `mode`，则默认为 `'r'`。
用于从文件中读取内容。如果文件不存在，会引发 `FileNotFoundError`。
虽然我们今天主要讲写入，但了解它也很重要。

在这些模式后面，你还可以加上 `'t'` 或 `'b'` 来指定文件是文本模式（默认）还是二进制模式。例如，`'wt'` 就是以文本模式写入，`'wb'` 是以二进制模式写入。对于TXT文件，我们通常使用文本模式，所以可以省略 `'t'`。

写入内容到TXT文件：`write()` 与 `writelines()`

文件被成功打开后，我们就可以通过文件对象的方法向其中写入内容了。

1. `write(string)`：写入单个字符串

这是最基本的写入方法，每次调用会将一个字符串写入文件。# 示例 1: 使用 'w' 模式创建并写入文件 (会覆盖旧内容)
file_path_w = ""
with open(file_path_w, 'w', encoding='utf-8') as f:
("Hello, Python world!")
("这是通过Python创建的第一个TXT文件。")
("新的一行内容。")
print(f"文件 '{file_path_w}' 已创建并写入内容。")
# 示例 2: 使用 'a' 模式向文件追加内容
file_path_a = "" # 沿用上一个文件
with open(file_path_a, 'a', encoding='utf-8') as f:
("--- 这是追加的内容 ---")
("追加模式不会覆盖原有内容。")
print(f"文件 '{file_path_a}' 已追加内容。")

温馨提示： `write()` 方法不会自动添加换行符，如果你想让内容分行显示，记得在字符串末尾手动加上 ``。

2. `writelines(list_of_strings)`：写入字符串列表

如果你有一个包含多行内容的字符串列表，`writelines()` 方法可以非常方便地一次性将它们写入文件。同样，它也不会自动添加换行符，列表中的每个字符串如果代表一行，也需要自己包含 ``。# 示例 3: 使用 'w' 模式写入一个字符串列表
lines_to_write = [
"第一行内容。",
"第二行内容，来自列表。",
"第三行内容，依然是列表的一部分。"
]
file_path_lines = ""
with open(file_path_lines, 'w', encoding='utf-8') as f:
(lines_to_write)
("这是在writelines之后，单独写入的一行。")
print(f"文件 '{file_path_lines}' 已写入多行内容。")

文件操作的“黄金法则”：`with` 语句

你可能已经注意到，上面的所有例子都使用了 `with open(...) as f:` 这样的结构。这可不是随便写的，它是Python文件操作的最佳实践，我们称之为上下文管理器。

为什么推荐使用 `with` 语句呢？
自动关闭文件： 文件操作完毕后，无论过程中是否发生错误（比如代码异常），`with` 语句都能确保文件被正确、及时地关闭。这对于释放系统资源、防止数据丢失或文件损坏至关重要。
避免资源泄漏： 如果不使用 `with` 语句，你需要手动调用 `()` 来关闭文件。一旦忘记或者程序意外终止，文件资源就可能一直被占用，造成资源泄漏。

所以，请牢记，在Python中进行文件操作，务必使用 `with` 语句！

独占创建模式 (`'x'`) 的妙用与错误处理

当我们只想创建一个全新的文件，并确保它之前不存在时，`'x'` 模式就派上用场了。如果文件已存在，它会抛出 `FileExistsError`。我们可以利用 `try-except` 语句来优雅地处理这种情况。# 示例 4: 使用 'x' 模式独占创建文件
file_path_exclusive = ""
try:
with open(file_path_exclusive, 'x', encoding='utf-8') as f:
("这条内容只会在文件第一次创建时写入。")
print(f"文件 '{file_path_exclusive}' 成功独占创建并写入。")
except FileExistsError:
print(f"文件 '{file_path_exclusive}' 已经存在，无法使用 'x' 模式创建。")
except Exception as e:
print(f"发生未知错误：{e}")
# 再次运行上面的代码，你会看到 FileExistsError 被捕获

更复杂的写入场景：数据结构化与格式化

实际开发中，我们往往需要将结构化的数据（如列表、字典）写入文件。这时，我们需要先将它们转换成字符串形式，并考虑如何保持可读性。# 示例 5: 写入结构化数据 (学生信息)
students_data = [
{"name": "张三", "age": 20, "major": "计算机科学"},
{"name": "李四", "age": 22, "major": "软件工程"},
{"name": "王五", "age": 21, "major": "数据科学"}
]
file_path_data = ""
with open(file_path_data, 'w', encoding='utf-8') as f:
("学生信息列表：")
("---------------------")
for student in students_data:
# 使用 f-string 格式化输出，方便阅读
(f"姓名: {student['name']}, 年龄: {student['age']}, 专业: {student['major']}")
("---------------------")
print(f"学生信息已写入 '{file_path_data}'。")

Python文件操作的常见问题与最佳实践

在进行文件操作时，一些细节可能会导致问题，以下是一些常见的“坑”和“避坑指南”：
编码问题： 对于包含非ASCII字符（如中文）的文件，务必在 `open()` 函数中指定 `encoding='utf-8'`。否则，可能会出现乱码或编码解码错误。
路径问题： 确保文件路径是正确的。相对路径会从脚本运行的当前目录开始查找。如果文件不在同一目录下，最好使用绝对路径，或者使用 `os` 模块来构建跨平台的路径，例如 `()`。
忘记关闭文件： 这是新手最常犯的错误。使用 `with` 语句是解决此问题的最佳方案。
模式选择错误： 搞清楚 `w`（覆盖）、`a`（追加）和 `x`（独占创建）的区别。根据你的需求选择正确的模式，避免数据丢失或意外的文件创建。
权限问题： 在某些操作系统或特定目录下，你可能没有写入文件的权限，这会引发 `PermissionError`。确保你的程序有足够的权限。

总结与展望

通过本文，我们详细学习了如何使用Python创建、写入和管理TXT文本文件。我们掌握了 `open()` 函数的核心参数，特别是各种文件打开模式 (`'w'`, `'a'`, `'x'`) 的使用场景；学会了 `write()` 和 `writelines()` 方法来向文件写入内容；更重要的是，我们理解并实践了文件操作的“黄金法则”——`with` 语句，确保文件资源得到妥善管理。

文件操作是数据持久化的第一步。掌握了TXT文件的读写，你就迈出了坚实的一步。当然，Python的文件操作远不止于此，你还可以学习如何读取文件、处理CSV文件、JSON文件，甚至与数据库进行交互。但一切都始于这基础而强大的TXT文件操作。

希望这篇文章能帮助你更好地理解和运用Python进行文件操作。现在，就动手实践一下吧！

2025-11-19

下一篇：【零基础】Python树莓派编程实战：从入门到第一个智能项目