Python 文件错误处理

在 Python 中处理文件时，打开和关闭文件是基础操作。然而，这些操作以及读取和写入数据时，有时会遇到错误。这些错误可能由各种原因引起，例如文件不存在、没有访问文件的权限，或者文件正在被其他程序使用。为了优雅地处理这些潜在错误并防止我们的程序崩溃，我们使用 try 和 except 代码块。

本章将全面介绍在进行文件操作时，如何使用 try 和 except 代码块进行有效的错误处理。

1. 理解 try 和 except 代码块

Python 中的 try 和 except 代码块用于处理异常（Exceptions），也就是程序执行期间发生的错误。

基本结构是将可能引发异常的代码放在 try 块中。如果在 try 块中发生了异常，程序会立即跳转到处理该特定异常类型的 except 块。如果没有发生异常，则会跳过 except 块。

1.1 基本语法

try 和 except 代码块的基础结构如下：

try:
    # 可能会引发异常的代码
    # 例如：文件操作
except SomeExceptionType: # 替换为具体的异常类型
    # 处理异常的代码
    # 例如：打印错误信息或采取补救措施

1.2 示例：处理 FileNotFoundError

在处理文件时，一个常见的错误是 FileNotFoundError（文件未找到错误），它发生在你尝试打开一个不存在的文件时。让我们看看如何处理它：

try:
    file = open("nonexistent_file.txt", "r") # 尝试打开一个不存在的文件
    content = file.read()
    print(content)
    file.close()
except FileNotFoundError:
    print("错误：找不到文件 'nonexistent_file.txt'。")
except Exception as e:
    print(f"发生了一个意外错误：{e}") # 通用异常处理

在这个例子中，如果 "nonexistent_file.txt" 不存在，open() 函数将引发一个 FileNotFoundError。随后，程序将执行 except FileNotFoundError: 块中的代码，打印一条清晰的错误信息。如果发生任何其他类型的错误，第二个 except 块（Exception as e）会将其捕获。

2. 处理多个异常

你可以通过包含多个 except 块，在单个 try 结构中处理多种类型的异常。每个 except 块都可以设计为捕获特定类型的错误。

try:
    file = open("my_file.txt", "r")
    content = file.read()
    number = int(content) # 尝试将内容转换为整数，可能会引发 ValueError
    result = 10 / number  # 尝试除以该数字，可能会引发 ZeroDivisionError
    print(result)
    file.close()
except FileNotFoundError:
    print("错误：找不到文件。")
except ValueError:
    print("错误：文件中的数据无效。无法转换为数字。")
except ZeroDivisionError:
    print("错误：不能除以零。")
except Exception as e:
    print(f"发生了一个意外错误：{e}")

在这个例子中：

• 如果文件不存在，会处理 FileNotFoundError。
• 如果文件内容无法转换为整数，会处理 ValueError。
• 如果转换后的数字是零，会处理 ZeroDivisionError。
• 最后一个 except 块用于捕获任何其他未预料到的异常。

3. else 代码块

你还可以在所有 except 块之后添加一个 else 代码块。只有当 try 块中没有发生任何异常时，else 块内部的代码才会执行。

try:
    file = open("my_file.txt", "r")
    content = file.read()
except FileNotFoundError:
    print("错误：找不到文件。")
else:
    print("文件打开成功。")
    file.close()

在这里，只有当 "my_file.txt" 被成功打开（即没有引发 FileNotFoundError）时，才会打印 "文件打开成功。" 并执行关闭文件的操作。

4. finally 代码块

finally 代码块用于指定无论是否发生异常都必须执行的代码。这通常用于清理资源，比如强制关闭文件。

file = None  # 在 try 块外部初始化 file 变量
try:
    file = open("my_file.txt", "r")
    content = file.read()
    print(content)
except FileNotFoundError:
    print("错误：找不到文件。")
finally:
    if file:
        file.close()
        print("文件已关闭。")
    else:
        print("文件从未被打开过。")

在这个例子中，finally 块确保文件被关闭，无论文件是成功打开了，还是遇到了 FileNotFoundError。请注意，我们在 try 块外部初始化了 file = None，这样 finally 块就能访问到这个变量。这是在 try...except...finally 结构中处理文件操作时的一种常见模式。

5. 实际案例与演示

5.1 案例 1：带错误处理的文件写入

假设你需要将数据写入文件，但希望处理诸如权限不足或磁盘空间不足导致文件无法写入的潜在错误。

try:
    file = open("output.txt", "w")
    file.write("这是要写入文件的一些数据。\n")
    file.write("另一行数据。\n")
except IOError as e:
    print(f"错误：无法写入文件。{e}")
finally:
    if file:
        file.close()
        print("文件已关闭。")

在这个例子中，我们捕获了 IOError（输入/输出错误），如果程序没有必要的写入权限或磁盘空间耗尽，就会发生这种错误。finally 块确保即使发生错误，文件也能被关闭。

5.2 案例 2：读取文件并处理数据

假设你正在从文件中读取数字并计算它们的总和。你需要处理文件不存在时的 FileNotFoundError，以及文件包含非数字数据时的 ValueError。

def calculate_sum_from_file(filename):
    total = 0
    try:
        file = open(filename, "r")
        for line in file:
            try:
                number = float(line.strip()) # 将每一行转换为浮点数
                total += number
            except ValueError:
                print(f"警告：跳过无效数据：{line.strip()}")
        return total
    except FileNotFoundError:
        print(f"错误：找不到文件 '{filename}'。")
        return None
    finally:
        if 'file' in locals() and file:  # 确保 'file' 已定义且已打开，然后再关闭
            file.close()
            print("文件已关闭。")

# 示例用法
filename = "numbers.txt"
file = open(filename, "w") # 创建 numbers 文件
file.write("1\n")
file.write("2\n")
file.write("abc\n") # 故意放入无效数据
file.write("4\n")
file.close()

sum_of_numbers = calculate_sum_from_file(filename)
if sum_of_numbers is not None:
    print(f"文件中数字的总和为：{sum_of_numbers}")

在这个例子中，calculate_sum_from_file 函数处理了两种异常。内部的 try...except 块处理了将每行转换为浮点数时可能出现的 ValueError，这使得函数能够跳过无效数据并继续处理文件的其余部分。finally 块确保文件被妥善关闭。

5.3 案例 3：使用 with 语句自动管理资源

Python 的 with 语句提供了一种简洁的方式来管理文件等资源，确保它们即使在发生异常时也能被正确关闭。这消除了我们显式编写 try...finally 来关闭文件的需要。

def read_file_content(filename):
    try:
        with open(filename, 'r') as file:
            content = file.read()
            return content
    except FileNotFoundError:
        print(f"错误：找不到文件 '{filename}'。")
        return None
    except IOError as e:
        print(f"读取文件时出错：{e}")
        return None

# 示例用法
filename = "example.txt"
file = open(filename, "w") # 创建文件
file.write("你好，世界！\n")
file.close()

content = read_file_content(filename)
if content:
    print("文件内容：\n", content)

在这个例子中，with open(...) as file: 语句会在退出该代码块时自动关闭文件，无论是否发生异常。这使代码更加整洁，并且不容易发生资源泄漏。IOError 是一个更广泛的异常，涵盖了各种与输入/输出相关的错误，包括文件读取期间的问题。