Python使用ftplib连接FTP并递归下载文件夹的完整实现
本文详细介绍如何使用Python的ftplib模块连接FTP服务器，并实现文件夹的递归下载。内容涵盖匿名登录、目录遍历、文件名解析（处理空格与中文）、递归逻辑实现以及常见错误（如编码错误、路径错误、命令格式错误）的解决方案，提供完整代码示例。
第一章：连接 FTP 服务器并实现文件夹下载
① 连接 FTP 服务器
若无需用户名和密码即可访问，通常使用的是默认匿名用户 Anonymous，且密码为空。
# -*- coding: UTF8 -*-
# 2022-3-8
# 作者：小蓝枣
# python连接ftp服务器
from ftplib import FTP
def conn_ftp():
'''
作用：连接ftp服务器
参数：无
返回：ftp服务器连接的对象
'''
# FTP连接信息
ftp_ip = "xx.xx.xx.xx"
# 默认端口21
ftp_port = 21
# 如果未指定，使用默认用户名为Anonymous，密码为空
ftp_user = "Anonymous"
ftp_password = ""
ftp = FTP()
# 连接ftp
ftp.connect(ftp_ip, ftp_port)
# ftp登录
ftp.login(ftp_user, ftp_password)
# 查看欢迎信息
print(ftp.getwelcome())
return ftp
ftp = conn_ftp()
② 进入指定目录并显示文件信息
调用 ftp.dir() 方法时，其返回结果末尾通常会附带 None，若目录为空则直接返回 None。
def display_dir(ftp, path):
'''
作用：进入并展示指定的目录内容
参数1：ftp连接对象
参数2：要展示的目录
返回：无
'''
# 进入指定目录
ftp.cwd(path)
# 显示当前所在位置
print("当前所在位置为：")
print(ftp.pwd())
# 展示目录内容
print("\n显示目录内容：")
print(ftp.dir())
# 展示目录下的文件名，*文件夹和文件都会显示
print("\n文件和文件夹名为：")
for i in ftp.nlst():
print(i)
path = "/CaseData/nc.vo.sdp.testcase.testcase.TestcaseHVO/"
display_dir(ftp, path)
这是原始目录。
③ 区分文件和文件夹名
通过 ftp.dir() 的返回结果，可以识别包含 <DIR> 标识的条目，据此区分文件夹与文件。
def diff_dir(ftp, path):
'''
作用：区分文件和文件夹
参数1：ftp连接对象
参数2：要展示的目录
返回：无
'''
# 进入指定目录
ftp.cwd(path)
# 显示当前所在位置
print("当前所在位置为：")
print(ftp.pwd())
# 展示目录内容
print("\n显示目录内容：")
dirs = []
ftp.dir(".", dirs.append)
for i in dirs:
# 区分文件和文件夹
if("<DIR>" in i):
print("目录为：" + i.split(" ")[-1])
else:
print("文件为：" + i.split(" ")[-1])
path = "/CaseData/nc.vo.sdp.testcase.testcase.TestcaseHVO/"
diff_dir(ftp, path)
④ 文件夹名包含空格处理
直接使用 split(" ")[-1] 截取文件名在遇到含空格的文件或文件夹名时会出错，下文提供了更有效的解决方案。
def get_dir_name(s):
'''
作用：需要文件或文件夹名
参数1：需要截取的字符串
返回：文件或文件夹名
'''
dir_name = ""
k = 0
record = ""
for i in s:
if(record == " " and i != " "):
k = k + 1;
if(k >= 3):
dir_name = dir_name + i;
record = i
print(dir_name)
return dir_name
# 测试两条数据
get_dir_name("03-08-22 09:52AM <DIR> C2021.11_ZDHJC_004a")
get_dir_name("03-08-25 10:32AM 89098 hello .exe")
⑤ 使用递归实现：FTP服务器里的文件夹下载到本地
思路：
首先检查目录或文件是否包含指定关键词，若包含则执行下载操作。
同时判断是否为目录，若是目录，则在本地根据目录结构进行递归操作，并同步创建本地文件夹。
此处使用了两个方法：下方方法用于判断是否包含关键词，上方方法用于处理目录结构下的递归逻辑。
注意：由于使用的是同一个 FTP 连接对象，在递归进入某个子目录后，递归结束时需切换回之前的目录。
import pathlib
def download_dir(ftp, path, local_path):
'''
作用: 下载目录
参数1：ftp连接对象
参数2：要展示的目录
参数3：本地存放路径
返回：无
'''
# 进入指定目录
ftp.cwd(path)
# 区分文件和文件夹
dirs = []
ftp.dir(".", dirs.append)
for i in dirs:
try:
# 识别为目录进行递归
if("<DIR>" in i):
dir_name = get_dir_name(i)
local_path_new = local_path + "/" + dir_name
# 本地创建文件夹
pathlib.Path(local_path_new).mkdir(parents=True, exist_ok=True)
# 调用下载目录方法
download_dir(ftp, dir_name, local_path_new)
# 识别为文件进行下载
else:
file_name = get_dir_name(i)
local_filename = local_path + "/" + file_name
f = open(local_filename, "wb")
# 下载ftp文件
ftp.retrbinary('RETR ' + file_name, f.write)
f.close()
except Exception as e:
print(e)
# 退出当前目录
ftp.cwd("..")
def download_file(ftp, key, path, local_path):
'''
作用: 根据关键词下载文件
参数1：ftp连接对象
参数2：下载的关键词
参数3：要展示的目录
参数4：本地存放路径
返回：无
'''
# 进入指定目录
ftp.cwd(path)
# 区分文件和文件夹
dirs = []
ftp.dir(".", dirs.append)
for i in dirs:
if(key in i):
try:
# 识别为目录进行递归
if("<DIR>" in i):
dir_name = get_dir_name(i)
local_path_new = local_path + "/" + dir_name
# 本地创建文件夹
pathlib.Path(local_path_new).mkdir(parents=True, exist_ok=True)
# 调用下载目录方法
download_dir(ftp, dir_name, local_path_new)
else:
file_name = get_dir_name(i)
local_filename = local_path + "/" + file_name
f = open(local_filename, "wb")
# 下载ftp文件
ftp.retrbinary('RETR ' + file_name, f.write)
f.close()
except Exception as e:
print(e)
# 设置编码，解决上传的文件包含中文的问题
ftp.encoding = 'GBK'
key = "C2021.11_ZDHJC"
path = "/CaseData/nc.vo.sdp.testcase.testcase.TestcaseHVO/"
local_path = "D:/ftp下载"
download_file(ftp, key, path, local_path)
可以看到符合关键词的目录已被下载到本地。
同时，其内部的嵌套目录也同步被下载。
第二章：问题解决
① 下载的文件名包含中文【‘utf-8’ codec can’t decode byte …】
只需将 FTP 对象的编码设置为 GBK 即可解决。
ftp.encoding = 'GBK'
否则可能会报如下错误：UnicodeDecodeError: 'utf-8' codec can't decode byte 0xd7 in position 114: invalid continuation byte
② 指定的路径存在问题【550 The system cannot find the file specified.】
此前使用 split(" ")[-1] 方法截取文件名，因部分文件含中文导致截取后的名称错误。
因此报出 ftplib.error_perm: 550 The system cannot find the file specified. 的错误。
③ 下载文件前未加RETR标识【500 Command not understood.】
下载文件时，FTP 路径前需添加 'RETR '（注意末尾有空格），否则将报 500 错误。
# 下载ftp文件
ftp.retrbinary('RETR ' + file_name, f.write)
否则报 ftplib.error_perm: 500 Command not understood. 错误。
以上就是Python实现连接FTP并下载文件夹的详细内容，更多关于Python FTP下载文件夹的资料请关注本站其它相关文章！
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
