Python进阶：Day03 文件读写与异常处理最佳实践

内容摘要：Python进阶：Day03 文件读写与异常处理最佳实践,

在日常 Python 开发中，文件操作和异常处理是不可或缺的部分。无论是读取配置文件、处理日志，还是进行数据分析，都离不开对文件的操作。而健壮的程序离不开完善的异常处理机制。本篇文章将深入探讨 Python 中关于文件操作和异常处理的常见问题，并提供实用的代码示例和避坑指南。

文件读写：从入门到精通

Python 提供了简洁易用的文件操作接口。让我们从最基本的文件打开、读取、写入和关闭开始。

文件打开模式

open() 函数是文件操作的入口，它接受文件名和打开模式作为参数。常见的打开模式包括：

• 'r'：只读模式 (默认)。
• 'w'：写入模式，如果文件已存在，则覆盖；如果不存在，则创建。
• 'a'：追加模式，在文件末尾追加内容，如果文件不存在，则创建。
• 'x'：创建模式，如果文件已存在，则抛出 FileExistsError 异常。
• 'b'：二进制模式，用于处理非文本文件，如图片、音频等。
• 't'：文本模式 (默认)。
• '+'：读写模式，可以同时进行读写操作。

可以将以上模式组合使用，例如 'rb' 表示以二进制只读模式打开文件。

文件读取

# 读取整个文件内容
with open('example.txt', 'r', encoding='utf-8') as f:
    content = f.read()
    print(content)

# 逐行读取文件内容
with open('example.txt', 'r', encoding='utf-8') as f:
    for line in f:
        print(line.strip()) # strip() 方法去除行尾的换行符

# 读取指定数量的字符
with open('example.txt', 'r', encoding='utf-8') as f:
    partial_content = f.read(10) # 读取前 10 个字符
    print(partial_content)

# 读取所有行到一个列表中
with open('example.txt', 'r', encoding='utf-8') as f:
    lines = f.readlines()
    print(lines)

使用 with open() 语句可以确保文件在使用完毕后自动关闭，避免资源泄露。encoding='utf-8' 指定文件编码，防止出现乱码问题，尤其是在处理包含中文的文件时。这类似于在 Nginx 配置中设置 charset utf-8; 以保证网页正确显示中文。

文件写入

# 写入字符串到文件
with open('output.txt', 'w', encoding='utf-8') as f:
    f.write('Hello, World!\n')
    f.write('This is a new line.\n')

# 写入列表到文件
lines = ['Line 1\n', 'Line 2\n', 'Line 3\n']
with open('output.txt', 'w', encoding='utf-8') as f:
    f.writelines(lines) # 将列表中的字符串写入文件

# 追加内容到文件末尾
with open('output.txt', 'a', encoding='utf-8') as f:
    f.write('This is an appended line.\n')

需要注意的是，以 'w' 模式打开文件会清空原有内容，因此在写入重要文件时要格外小心。使用 'a' 模式可以安全地在文件末尾追加内容。

异常处理：打造健壮的程序

程序在运行过程中难免会遇到各种错误，例如文件不存在、网络连接超时、除数为零等。良好的异常处理机制可以提高程序的健壮性和可靠性。

try...except...finally 结构

try...except...finally 是 Python 中常用的异常处理结构。

try:
    # 可能引发异常的代码块
    num1 = int(input('Enter the first number: '))
    num2 = int(input('Enter the second number: '))
    result = num1 / num2
    print('Result:', result)
except ValueError:
    # 处理 ValueError 异常，例如用户输入了非数字字符
    print('Invalid input. Please enter numbers only.')
except ZeroDivisionError:
    # 处理 ZeroDivisionError 异常，例如除数为零
    print('Cannot divide by zero.')
except Exception as e:
    # 处理其他类型的异常
    print('An error occurred:', e)
finally:
    # 无论是否发生异常，都会执行的代码块
    print('Execution completed.')

try 块包含可能引发异常的代码。如果 try 块中的代码引发了异常，Python 会查找与该异常类型匹配的 except 块，并执行该块中的代码。finally 块中的代码无论是否发生异常都会执行，通常用于释放资源，例如关闭文件、关闭数据库连接等。类似于在处理 Nginx 配置错误后，需要重启 Nginx 服务才能生效。

自定义异常

可以创建自定义异常类来表示应用程序特定的错误。

class MyCustomError(Exception):
    def __init__(self, message):
        super().__init__(message)
        self.message = message

    def __str__(self):
        return f'MyCustomError: {self.message}'


def process_data(data):
    if not isinstance(data, list):
        raise MyCustomError('Data must be a list.')
    # 其他处理数据的代码


try:
    process_data('invalid data')
except MyCustomError as e:
    print(e)

自定义异常类通常继承自内置的 Exception 类，并可以添加自定义的属性和方法。通过 raise 语句可以手动引发异常。

异常处理的原则

• 不要过度使用异常处理：异常处理应该用于处理真正异常的情况，而不是用于控制程序的正常流程。
• 只捕获你能够处理的异常：如果无法处理某个异常，应该将其向上抛出，让调用者来处理。
• 提供清晰的错误信息：错误信息应该能够帮助用户或开发者快速定位问题。
• 使用 finally 块释放资源：确保资源在使用完毕后能够被正确释放。

实战避坑经验

• 文件编码问题：在处理文本文件时，一定要注意文件编码，避免出现乱码。建议统一使用 UTF-8 编码。
• 文件路径问题：使用相对路径时，要注意当前工作目录。可以使用 os.path.abspath() 函数获取文件的绝对路径。
• 资源泄露问题：使用 with open() 语句可以避免资源泄露。如果使用手动打开和关闭文件的方式，一定要确保在所有情况下都能够正确关闭文件。
• 异常处理的粒度：尽量精确地捕获异常，避免捕获过多的异常导致程序难以调试。

掌握文件操作和异常处理是 Python 编程的基础。通过本文的学习，相信你已经对 Python 中关于文件操作和异常处理有了更深入的理解。在实际开发中，灵活运用这些知识，可以编写出更加健壮、可靠的程序。类似于在 Nginx 配置中合理设置 try_files 指令，可以有效地处理静态资源请求，并提供更好的用户体验。