在 Python 中处理 ZIP 压缩文件时，可以使用 `try-except` 块来捕获操作过程中可能出现的异常，并通过日志记录或打印语句输出详细的错误信息。以下是一个完整的示例，展示了如何在解压 ZIP 文件的过程中进行异常捕获和信息输出。 ```python import os import pyzipper import logging # 配置日志记录 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s') logger = logging.getLogger(__name__) def decode_filename(encoded_name): """尝试解码文件名以支持中文字符""" try: return encoded_name.encode('cp437').decode('gbk') except UnicodeDecodeError: return encoded_name.encode('utf-8').decode('utf-8') def unzip_file(zip_file_path: str, target_folder: str, password: str = None) -> None: """ 解压 ZIP 文件到指定文件夹。 :param zip_file_path: ZIP 文件路径 :param target_folder: 目标解压目录 :param password: ZIP 文件密码（可选） """ try: with pyzipper.AESZipFile(zip_file_path, 'r') as zip_file: if password: zip_file.setpassword(password.encode('utf-8')) for info in zip_file.infolist(): file_name = decode_filename(info.filename) file_path = os.path.join(target_folder, file_name) if info.is_dir(): os.makedirs(file_path, exist_ok=True) else: with zip_file.open(info) as source, open(file_path, 'wb') as target: target.write(source.read()) logger.info(f"解压完成！解压到：{target_folder}") except FileNotFoundError: logger.error("ZIP 文件不存在。") except pyzipper.BadZipFile: logger.error("ZIP 文件损坏。") except RuntimeError as e: logger.error(f"密码错误或解压失败: {e}") except PermissionError as e: logger.error(f"权限不足，无法写入目标文件夹: {e}") except Exception as e: logger.error(f"发生未知错误: {e}") # 示例调用 if __name__ == "__main__": zip_file_path = "example.zip" target_folder = "output_directory" password = "your_password_here" unzip_file(zip_file_path, target_folder, password) ``` ### 异常捕获详解 1. **FileNotFoundError**：当指定的 ZIP 文件不存在时会触发此异常。可以通过 `logger.error()` 输出错误信息，提示用户检查文件路径是否正确[^1]。 2. **pyzipper.BadZipFile**：如果 ZIP 文件损坏或格式不正确，则会抛出该异常。此时应提示用户 ZIP 文件可能已损坏[^1]。 3. **RuntimeError**：通常用于处理密码错误的情况，尤其是在使用 `pyzipper` 库时，密码不匹配会导致该异常[^1]。 4. **PermissionError**：当程序没有权限写入目标文件夹时会触发此异常，这种情况常见于尝试将文件解压到只读目录或受保护的系统路径中[^3]。 5. **通用异常捕获**：为了防止遗漏其他类型的异常，可以使用 `Exception` 类来捕获所有未明确列出的异常，并记录相应的错误信息。 ### 日志记录与调试 - 使用 `logging` 模块可以帮助开发者更好地跟踪程序运行状态，特别是在处理文件操作时，能够清晰地看到每个步骤的成功与否。 - 在实际部署中，建议将日志级别设置为 `INFO` 或更高，以便在出现问题时快速定位原因。 ---