PyQt5中QListWidget路径传入os.walk报错的解决问询

问题背景 #

学习Python数周的新手在基于PyQt5制作PDF合并工具时，新增批量合并子文件夹PDF功能遇到报错：

1. 最初版本报错：expected str, bytes or os.PathLike object, not ListWidget
2. 修改后报错：TypeError: item(self, row: int): not enough arguments

核心需求：将QListWidget中添加的多个文件夹路径传入os.walk，实现递归合并每个文件夹下的PDF文件。

错误原因分析 #

1. 第一个错误：直接把QListWidget控件对象传给os.walk()，但os.walk()需要的是字符串格式的文件夹路径，而非控件本身。
2. 第二个错误：QListWidget.item()方法必须传入行号参数（如item(0)）才能获取对应行的内容，直接调用item()会参数不足。
3. 原代码存在缩进错误：os.walk()的循环块未正确包裹后续的文件处理逻辑，导致merger和files变量作用域错误。

修正后的代码实现 #

以下是修复后的batch_merge方法，可处理QListWidget中所有添加的文件夹路径，每个文件夹递归合并其下所有PDF并保存到原文件夹：

def batch_merge(self):
    # 遍历QListWidget中的所有文件夹路径
    for row in range(self.pdfListWidget.count()):
        folder_path = self.pdfListWidget.item(row).text()
        # 检查路径是否有效
        if not os.path.isdir(folder_path):
            self.dialogMessage(f"无效路径：{folder_path}")
            continue
        
        merger = PdfMerger()
        # 递归遍历文件夹及其子文件夹
        for root, _, files in os.walk(folder_path):
            for filename in files:
                if filename.endswith(".pdf"):
                    filepath = os.path.join(root, filename)
                    try:
                        merger.append(PdfReader(open(filepath, 'rb')))
                    except Exception as e:
                        self.dialogMessage(f"处理文件失败：{filepath}\n错误：{str(e)}")
        
        # 生成输出文件名（保存到原文件夹，以文件夹名命名）
        output_filename = os.path.join(folder_path, f"{os.path.basename(folder_path)}_merged.pdf")
        try:
            merger.write(output_filename)
            merger.close()
            self.dialogMessage(f"文件夹 {folder_path} 合并完成，保存为：{output_filename}")
        except Exception as e:
            self.dialogMessage(f"保存合并文件失败：{str(e)}")

关键改进点 #

• 遍历QListWidget所有路径：用range(self.pdfListWidget.count())获取所有行号，逐个取出路径字符串。
• 路径有效性检查：添加os.path.isdir()验证路径是否为有效文件夹，避免无效输入。
• 修复缩进问题：将文件遍历和合并逻辑放入os.walk()的循环块内，确保作用域正确。
• 异常处理细化：对单个文件处理和最终保存操作分别捕获异常，提升工具健壮性。
• 合理命名输出文件：将合并后的PDF以原文件夹名+_merged.pdf命名，保存到原文件夹下，避免覆盖或混乱。

可选调整 #

如果希望将所有文件夹的合并结果保存到指定的统一输出路径，可以修改输出文件名部分：

# 统一输出路径（从outputFIle控件获取）
base_output_path = self.outputFIle.text()
if not base_output_path:
    self.dialogMessage("请先指定输出路径")
    return
# 确保输出路径存在
os.makedirs(base_output_path, exist_ok=True)
output_filename = os.path.join(base_output_path, f"{os.path.basename(folder_path)}_merged.pdf")

内容的提问来源于stack exchange，提问作者reoru 44