如何使用ftplib在FTP服务器中高效递归查找指定文件？

好问题！手动用FTP.cwd()和retrlines('LIST')来回切换目录、解析列表确实重复又低效，我们可以通过两种方式实现类似os.walk()的便捷遍历：

1. 基于ftplib手动实现类似os.walk的递归遍历 #

如果不想引入额外依赖，可以自己封装一个递归函数，推荐用MLSD命令替代LIST——它的输出是标准化的机器可读格式，解析起来更可靠，效率也更高（大部分现代FTP服务器都支持）。

示例代码如下：

from ftplib import FTP

def ftp_walk(ftp, current_dir='/'):
    """模拟os.walk，遍历FTP服务器目录，返回(当前目录, 子目录列表, 文件列表)"""
    try:
        # 使用MLSD获取目录项，返回的是(文件名, 属性字典)的迭代器
        entries = []
        ftp.retrlines('MLSD', callback=lambda line: entries.append(line.split('; ', 1)))
        
        dirs = []
        files = []
        for attr_str, name in entries:
            # 解析属性，判断是目录还是文件
            attrs = dict(item.split('=', 1) for item in attr_str.split(';') if '=' in item)
            if attrs.get('type') == 'dir':
                dirs.append(name)
            elif attrs.get('type') == 'file':
                files.append(name)
        
        yield current_dir, dirs, files
        
        # 递归遍历子目录
        for dir_name in dirs:
            next_dir = f"{current_dir}/{dir_name}" if current_dir != '/' else f"/{dir_name}"
            # 切换到子目录
            ftp.cwd(next_dir)
            yield from ftp_walk(ftp, next_dir)
            # 切回父目录
            ftp.cwd('..')
    except Exception as e:
        print(f"访问目录 {current_dir} 失败: {e}")
        return

# 使用示例
def find_file_on_ftp(ftp_host, ftp_user, ftp_pass, target_filename):
    ftp = FTP(ftp_host)
    ftp.login(ftp_user, ftp_pass)
    
    for current_dir, _, files in ftp_walk(ftp):
        if target_filename in files:
            print(f"找到文件: {current_dir}/{target_filename}")
    
    ftp.quit()

# 调用示例
find_file_on_ftp('your-ftp-host.com', 'username', 'password', 'target.txt')

2. 使用ftputil库（封装好的类os接口） #

如果想要更简洁的代码，可以用ftputil——这个库对ftplib做了封装，提供了和本地文件系统操作几乎一致的API，包括walk方法，完全不用自己处理递归逻辑。

首先安装库：

pip install ftputil

然后使用示例：

import ftputil

def find_file_with_ftputil(ftp_host, ftp_user, ftp_pass, target_filename):
    with ftputil.FTPHost(ftp_host, ftp_user, ftp_pass) as host:
        # 像os.walk一样遍历
        for root, _, files in host.walk('/'):
            if target_filename in files:
                print(f"找到文件: {host.path.join(root, target_filename)}")

# 调用示例
find_file_with_ftputil('your-ftp-host.com', 'username', 'password', 'target.txt')

注意事项 #

• 部分老旧FTP服务器可能不支持MLSD命令，这时可以 fallback 到LIST命令，但需要自己解析不同格式的列表输出（比如Unix风格或Windows风格的LIST结果），解析难度会大一些。
• 遍历前确认你有对应目录的访问权限，避免因权限不足导致遍历中断。
• 如果FTP服务器目录层级极深，手动递归可能触发栈溢出，可以把递归改成迭代式（用栈或队列存储待遍历目录）。

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