Python - Rarfile 模块

---

---

在 Python 中，**rarfile** 模块用于处理 rar 压缩文件（.rar 文件）。通过使用 **rarfile** 模块，您可以获取文件、列出源内容，甚至直接读取压缩文件中的文件，而无需提取它们。此库是应用程序 **unrar** 或 **rar** 的直接 Python 访问，后者必须在命令级别安装。

在本教程中，我们将学习 **rarfile** 模块的安装方法、使用方法、模块提供的多种方法以及简单的示例。

安装 rarfile 模块

要使用 **rarfile** 模块，您必须安装它以及 **unrar** 或 **rar** 工具，这些工具将在模块内部使用以处理 RAR 压缩文件。

要安装 rarfile 模块，请使用以下命令：

pip install rarfile

安装 WinRAR 实用程序

提取和处理 RAR 文件需要 **WinRAR** 命令行工具。您可以从官方 WINRAR 网站下载它。下载适用于 Windows 的 **WinRAR** 并安装。

将 **C:\Program Files\WinRAR\** 添加到系统的 **Path** 环境变量中，以启用命令行访问。之后，WinRAR 将可以与 Python 的 **rarfile** 模块一起使用。

rarfile 模块的方法

以下是 rarfile 模块的重要方法：

rarfile模块示例

安装rarfile模块和winrar后，您就可以开始在Python中使用RAR文件。以下是一些示例：

示例1：显示RAR档案的内容

在此示例中，我们将看到如何在不提取的情况下列出RAR档案中包含的所有文件。它打印档案中每个文件的名称和大小：

from rarfile import RarFile

# Path to the RAR file
file_archive = 'data_archive.rar'

# Open the RAR file
archive_instance = RarFile(file_archive)

try:
   # Process each file in the RAR archive
   for file_entry in archive_instance.infolist():
      print(f"Name: {file_entry.filename}, Size: {file_entry.file_size} bytes")
finally:
   # Ensure the file is closed properly
   archive_instance.close()

示例2：将RAR档案中的所有文件提取到目录

此示例演示如何将RAR档案中的所有文件提取到指定的目录。它确保在提取后正确关闭RAR文件：

import rarfile
# Specify the path to unrar.exe
rarfile.UNRAR_TOOL = r"C:\Program Files\WinRAR\Unrar.exe"
# Path to the RAR file
rar_file_location = “text.rar"
# Directory where files will be extracted
output_directory = './extracted_files'

# Access the RAR file
rar_archive = rarfile.RarFile(rar_file_location)

try:
   # Extract all contents to the specified directory
   rar_archive.extractall(path=output_directory)
finally:
   # Close the RAR file to release system resources
   rar_archive.close()

示例3：从RAR档案中提取单个文件

在此示例中，我们将特定文件从RAR档案提取到给定目录。代码在提取之前检查文件是否存在：

import rarfile
# Location of the RAR file
rar_file_path = 'data_archive.rar'
# Name of the file to extract
target_file = 'report.txt'
# Open the RAR file
rar_archive = rarfile.RarFile(rar_file_path)
try:
   # Extract the specific file to the target directory
   rar_archive.extract(target_file, path='./extracted_files')
finally:
   # Close the RAR file to release resources
   rar_archive.close()

示例4：直接从RAR档案读取文件（无需提取）

此示例说明如何在不提取的情况下读取RAR档案内文件的內容。文件直接从档案中打开和读取，并打印其内容：

import rarfile
# Location of the RAR file
compressed_file_path = 'data_archive.rar'
# File to be read from within the RAR archive
inner_file = 'notes.txt'
# Open the RAR file
rar_archive = rarfile.RarFile(compressed_file_path)
try:
   # Access and read the contents of the specified file inside the archive
   extracted_file = rar_archive.open(inner_file)
   try:
      file_content = extracted_file.read()
      print(file_content.decode('utf-8'))  # Assuming the file contains text
   finally:
      extracted_file.close()
finally:
   # Close the RAR archive
   rar_archive.close()

示例5：验证RAR档案中是否存在文件

此示例演示如何检查特定文件是否存在于RAR档案中。如果找到该文件，则会显示一条消息指示其存在：

import rarfile

# Path to the RAR archive
rar_file_location = 'data_archive.rar'
# Name of the file to check within the archive
target_file_name = 'report.txt'

# Open the RAR archive
rar_archive = rarfile.RarFile(rar_file_location)

try:
   # Check if the file exists in the archive
   if target_file_name in rar_archive.namelist():
      print(f"'{target_file_name}' is available in the archive.")
   else:
      print(f"'{target_file_name}' was not found in the archive.")
finally:
   # Close the RAR archive
   rar_archive.close()

输出

此示例演示如何将RAR档案中的所有文件提取到指定的文件夹中。（请参阅我们的示例2代码）

我们将Text.rar档案文件转换为Folder文件夹：