异常捕获是Python文件操作的必备环节，用于防止程序因文件不存在、权限不足等问题崩溃。通过try-except-finally或with open()机制可优雅处理异常，其中with语句能自动管理资源，确保文件正确关闭。常见异常包括FileNotFoundError、PermissionError和OSError，应优先捕获具体异常并针对性处理，再用Exception兜底。捕获后需提供用户反馈，并利用logging模块记录日志，区分错误级别，便于排查。日志应包含路径、错误原因等信息，必要时重新抛出异常，确保程序健壮性和可维护性。
Python文件操作时，难免会遇到各种预料之外的问题，比如文件不存在、权限不足、磁盘空间满等等。异常捕获就是为了优雅地处理这些情况，防止程序崩溃，确保用户体验和数据完整性。它不是可选的，而是编写健壮文件操作代码的必备环节。说白了，就是给你的文件操作代码加个“安全网”，让程序在遇到问题时，不是直接“死机”，而是能有条不紊地做出反应。
在Python中，处理文件操作异常的核心机制就是
try-except-finally
with open()
我们先从最基础的
try-except
try
except
import os
def read_file_robust(filepath):
try:
with open(filepath, 'r', encoding='utf-8') as f:
content = f.read()
print(f"文件 '{filepath}' 内容读取成功：\n{content[:100]}...") # 打印前100字
return content
except FileNotFoundError:
print(f"错误：文件 '{filepath}' 不存在。请检查路径是否正确。")
return None
except PermissionError:
print(f"错误：没有权限读取文件 '{filepath}'。请检查文件权限。")
return None
except Exception as e: # 捕获其他所有未预料的异常
print(f"读取文件 '{filepath}' 时发生未知错误：{e}")
return None
# 示例调用
# read_file_robust("non_existent_file.txt")
# read_file_robust("/root/some_protected_file.txt") # 假设没有权限
# read_file_robust("my_document.txt") # 假设存在且可读这里，我个人倾向于先捕获特定的异常，比如
FileNotFoundError
PermissionError
Exception
立即学习“Python免费学习笔记（深入）”；
finally
try
with open()
finally
在文件操作的世界里，各种“不顺心”的情况层出不穷。了解这些常见的异常类型，能帮助我们更精准地“对症下药”。
最常见的莫过于
FileNotFoundError
接着是
PermissionError
还有
IOError
OSError
FileNotFoundError
PermissionError
OSError
OSError
errno
import errno
def write_data_robust(filepath, data):
try:
with open(filepath, 'w', encoding='utf-8') as f:
f.write(data)
print(f"数据成功写入文件 '{filepath}'。")
except FileNotFoundError:
print(f"错误：写入时文件 '{filepath}' 的目录不存在。")
except PermissionError:
print(f"错误：没有权限写入文件 '{filepath}'。")
except OSError as e:
if e.errno == errno.ENOSPC: # 28: No space left on device
print(f"错误：磁盘空间不足，无法写入文件 '{filepath}'。")
elif e.errno == errno.EROFS: # 30: Read-only file system
print(f"错误：文件系统是只读的，无法写入文件 '{filepath}'。")
else:
print(f"写入文件 '{filepath}' 时发生操作系统错误：{e}")
except Exception as e:
print(f"写入文件 '{filepath}' 时发生未知错误：{e}")
# 示例调用
# write_data_robust("/non_existent_dir/test.txt", "Hello")
# write_data_robust("/etc/test.txt", "Hello") # 假设没有权限
# write_data_robust("/mnt/read_only_disk/test.txt", "Hello") # 假设是只读文件系统捕获策略上，我通常建议先捕获最具体的异常，然后逐步放宽到更通用的异常，最后可以有一个
Exception
Exception
with open()
说实话，手动管理文件句柄，尤其是忘记
f.close()
传统的做法是这样：
f = None
try:
f = open('some_file.txt', 'r')
content = f.read()
print(content)
except FileNotFoundError:
print("文件不存在。")
finally:
if f:
f.close() # 确保文件被关闭你看，为了一个简单的文件读取，你需要写好几行代码来确保文件关闭，这显得有些笨重。
这时候，
with open()
try:
with open('my_document.txt', 'r', encoding='utf-8') as f:
content = f.read()
print(f"文件内容：\n{content}")
except FileNotFoundError:
print("文件 'my_document.txt' 不存在。")
except PermissionError:
print("没有权限读取文件 'my_document.txt'。")
# 其他异常捕获...使用
with open()
f.close()
with
with open()
仅仅捕获了异常还不够，捕获之后我们应该做什么？这其实是个更深层次的问题。
首先，给用户一个清晰的反馈。如果你的程序是交互式的，告诉用户出了什么问题，比如“文件不存在，请检查路径”，比直接崩溃或者什么都不做要好得多。
其次，记录日志。对于生产环境的应用来说，日志是排查问题的生命线。当文件操作失败时，我们需要记录下失败的原因、发生的时间、涉及的文件路径，甚至尝试的操作类型。Python的
logging
import logging
import os
# 配置日志
logging.basicConfig(level=logging.ERROR,
format='%(asctime)s - %(levelname)s - %(message)s',
filename='file_operations.log',
filemode='a') # 'a' for append
def safe_delete_file(filepath):
try:
os.remove(filepath)
print(f"文件 '{filepath}' 已成功删除。")
logging.info(f"文件 '{filepath}' 删除成功。")
except FileNotFoundError:
print(f"警告：尝试删除的文件 '{filepath}' 不存在。")
logging.warning(f"尝试删除不存在的文件：{filepath}")
except PermissionError:
print(f"错误：没有权限删除文件 '{filepath}'。")
logging.error(f"权限不足，无法删除文件：{filepath}")
except OSError as e:
print(f"删除文件 '{filepath}' 时发生操作系统错误：{e}")
logging.error(f"删除文件 '{filepath}' 时发生操作系统错误：{e}")
except Exception as e:
print(f"删除文件 '{filepath}' 时发生未知错误：{e}")
logging.critical(f"删除文件 '{filepath}' 时发生未知且严重错误：{e}")
# 示例调用
# safe_delete_file("non_existent_file.txt")
# safe_delete_file("/root/some_protected_file.txt") # 假设没有权限
# safe_delete_file("temp_file_to_delete.txt") # 假设存在且可删除在上面的例子里，我使用了
logging.basicConfig
warning
error
critical
logging.exception()
有时候，你可能需要在捕获异常后，做一些清理工作，然后重新抛出异常。这通常发生在你的函数只是处理了部分异常，但更高层的调用者需要知道这个错误，并进行更全面的处理。你可以用
raise
raise NewException from OriginalException
在我看来，一个健壮的文件操作，不仅仅是避免程序崩溃，更重要的是在出错时能给出清晰的指示，并留下可供追溯的“痕迹”。日志记录就是这些“痕迹”的集合，它让我们的程序在遇到问题时，不再是一个黑箱。
以上就是Python 文件操作中的异常捕获案例的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
687
收藏
