Python实现连接FTP并下载文件夹

第一章：连接 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服务器里的文件夹下载到本地

思路：

首先是看目录或文件里是否包含关键词，包含关键词进行下载。

并判断是否是目录，如果是目录的话，本地根据目录结构进行递归，同时本地创建文件夹。

使用了 2 个方法，下面的方法用来判断是否包含关键词，上面的方法就是目录结构下的递归。

注意：由于是一个 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)

可以看到符合关键词的目录被下载到本地了。

并且里面的嵌套目录也同步被下载了。

第二章：问题解决

① 下载的文件名包含中文【&lsquo;utf-8&rsquo; codec can&rsquo;t decode byte &hellip;】

设置下 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. 错误了。

来源：https://blog.csdn.net/qq_38161040/article/details/123346360