如何用for循环遍历两个列表并正确打印缺失文件信息

我需要对比预设文件列表required_files和通过os.walk生成的实际文件列表，找出缺失文件并按指定格式输出。目前代码能实现基本功能，但存在问题：多个缺失文件时会重复输出相同语句，且把所有缺失路径合并显示；尝试循环遍历缺失文件输出时，又会重复打印同一行。

期望输出格式 #

File vocab\strict.xsd is missing at:
    C:\Users\....vocab\strict.xsd
File vocab\loose.xsd is missing at:
    C:\Users\....vocab\loose.xsd

实际错误输出 #

单个缺失文件时：

File vocab\strict.xsd is missing at
  {C:\Users\....vocab\strict,xsd}

多个缺失文件时：

File vocab\strict.xsd is missing at
 {C:\Users\....vocab\strict,xsd', 'C:\Users\...unique/strict'} #created a second false positive to test this one

现有代码 #

import os

required_files = [
    'datatypes.dtd'           ,
    'xml.xsd'                 ,
    'anyElement.xsd'          ,
    'dataTypes.dtd'           ,
    'extend/strict.xsd'       ,
    'unique/loose.xsd'        ,
    'unique/strict.xsd'       ,
    'vocab/custom.xsd'        ,
    'vocab/loose.xsd'         ,
    'vocab\\strict.xsd'        , #my test example. This is purposefully wrong to make sure it shows up to better debug
]

def check_name(x):
    path = x
    directory = path.replace("/", "\\")

    for d in next(os.walk(directory))[1]:
            itempath = os.path.join(directory, d)
            path = d
            if any(letter.isupper() for letter in path):
                    print(" Root folder contains invalid characters at:\n" + itempath) # skeleton veriifcation to make sure course root folder contains no uppercase letters
            
            required = [] 
            check_required = [] 
            for i in required_files:
                filepath = os.path.join(directory, d, i)
                required.append(filepath)

            for root, directories, files in os.walk(directory):

                 for name in directories: 
                  # Search for directories that contain any illegal characters 
                      if any(letter.isupper() for letter in name):
                              print(f"The Folder '{name}' contains illegal characters at\n" + os.path.join(root, name))

              for name in files:
                             # Search for files that contain any illegal characters , excluding any that ends with the extensions .xsd and .dtd
                      if not name.endswith(('.xsd', '.dtd')) and  not name.islower():
                                 print(f"The File '{name}' contains illegal characters at\n" + os.path.join(root, name))
                      elif name.endswith(('.xsd', '.dtd')):
                              check_required.append(root + '\\' + name)


            if required not in check_required:
                  missing_files = set(required) - set(check_required_files)
                  missing_file = str(missing_files).replace(r'\\\\', '\\') #I was getting a double slash issue when printed, so I added this to only get single slash
                  print(f'File {i} is missing at \n {missing_file}')

问题分析与修复方案 #

原代码存在的问题 #

1. 变量名错误：check_required_files未定义，实际应为check_required
2. 判断逻辑无效：if required not in check_required是将整个required列表作为元素查找，永远不会成立
3. 循环变量作用域错误：最后打印时使用的i是遍历required_files的最后一个元素，导致所有缺失文件都显示同一个文件名
4. 路径拼接不可靠：手动用root + '\\' + name拼接路径，容易出现分隔符错误
5. 逻辑混乱：required列表构建与check_required收集的逻辑交织，导致重复处理和错误判断

修改后的代码 #

import os

required_files = [
    'datatypes.dtd',
    'xml.xsd',
    'anyElement.xsd',
    'dataTypes.dtd',
    'extend/strict.xsd',
    'unique/loose.xsd',
    'unique/strict.xsd',
    'vocab/custom.xsd',
    'vocab/loose.xsd',
    'vocab\\strict.xsd', # 测试用的错误路径，确保能被检测到
]

def check_name(base_dir):
    # 统一路径分隔符为当前系统格式
    base_dir = os.path.normpath(base_dir)
    
    # 遍历根目录下的子文件夹
    for root_dir in next(os.walk(base_dir))[1]:
        current_root = os.path.join(base_dir, root_dir)
        
        # 检查根文件夹是否有大写字符
        if any(c.isupper() for c in root_dir):
            print(f"Root folder contains invalid characters at:\n    {current_root}")
        
        # 构建所有需要检查的文件的完整路径（用集合去重）
        required_full_paths = set()
        for rel_path in required_files:
            # 统一相对路径的分隔符
            norm_rel_path = os.path.normpath(rel_path)
            full_path = os.path.join(current_root, norm_rel_path)
            required_full_paths.add(full_path)
        
        # 收集实际存在的目标文件（.xsd/.dtd）的完整路径
        existing_target_files = set()
        for root, dirs, files in os.walk(base_dir):
            # 检查文件夹是否有大写字符
            for dir_name in dirs:
                if any(c.isupper() for c in dir_name):
                    print(f"The Folder '{dir_name}' contains illegal characters at\n    {os.path.join(root, dir_name)}")
            
            # 检查文件并收集目标文件路径
            for file_name in files:
                file_path = os.path.join(root, file_name)
                if not file_name.endswith(('.xsd', '.dtd')) and not file_name.islower():
                    print(f"The File '{file_name}' contains illegal characters at\n    {file_path}")
                elif file_name.endswith(('.xsd', '.dtd')):
                    existing_target_files.add(file_path)
        
        # 计算缺失的文件
        missing_files = required_full_paths - existing_target_files
        
        # 按要求格式逐个输出缺失文件信息
        for missing_path in missing_files:
            # 提取相对于当前根目录的路径，用于显示文件名部分
            rel_path = os.path.relpath(missing_path, current_root)
            # 转换为用户习惯的反斜杠分隔符
            rel_path = rel_path.replace('/', '\\')
            print(f"File {rel_path} is missing at:\n    {missing_path}")

# 调用示例，替换为你的实际目录
# check_name("C:\\Users\\YourUsername\\TargetDirectory")

关键修改说明 #

• 使用os.path.normpath统一处理路径，自动适配系统分隔符，避免手动替换的错误
• 用集合存储需要的文件和实际存在的文件，高效计算差集
• 遍历缺失文件集合，逐个输出，确保每条缺失信息独立显示
• 修复变量名错误，移除无效判断逻辑
• 用os.path.relpath提取相对路径，符合期望输出的文件名展示格式
• 整理代码缩进，提升可读性与维护性

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