python 中 ftplib库的使用说明

在Python3中，ftplib库是用于处理FTP协议的内置模块。以下是一些使用ftplib库的基本操作示例和说明：

1. 连接与登录FTP服务器

from ftplib import FTP

# 创建一个FTP对象
ftp = FTP()

# 连接到FTP服务器
ftp.connect('ftp.example.com', port=21)  # 默认端口为21
# 登录FTP服务器（如果需要用户名和密码）
ftp.login(user='username', passwd='password')

# 设置编码（可选，根据FTP服务器支持情况设置正确的字符编码）
ftp.encoding = 'utf-8'

2. 切换目录、查看目录列表

# 切换到远程目录
ftp.cwd('/remote/directory')

# 获取当前工作目录
print(ftp.pwd())

# 列出当前目录下的文件和子目录信息
ftp.dir()  # 打印到标准输出
lines = ftp.retrlines('LIST')  # 返回详细列表，每一项是一个字符串

# 使用`mlsd()`获取详细的元数据列表，返回值为字典列表
files_info = []
for item in ftp.mlsd():  # 需要服务器支持MLSD命令
    files_info.append(item)

3. 文件上传

# 本地文件路径
local_file_path = '/path/to/local/file.txt'

# 打开本地文件以读取二进制模式
with open(local_file_path, 'rb') as local_file:
    # 将本地文件上传到FTP服务器上指定位置
    ftp.storbinary(f'STOR remote_file.txt', local_file)

# 或者使用 `storlines` 上传文本文件（每行按ASCII格式发送）
# with open(local_file_path, 'r') as local_file:
#     ftp.storlines(f'STOR remote_file.txt', local_file)

4. 文件下载

# 远程文件名
remote_file_name = 'file.txt'
# 本地保存路径
local_save_path = '/path/to/save/downloaded_file.txt'

# 创建本地文件并打开以写入
with open(local_save_path, 'wb') as local_file:
    # 下载远程文件到本地
    ftp.retrbinary(f'RETR {remote_file_name}', local_file.write)

# 如果是文本文件，可以使用 `retrlines`
# 注意：这将逐行读取，并假设每行都是ASCII编码
# lines = []
# def append_line(line):
#     lines.append(line.decode(ftp.encoding))  # 解码为字符串
# ftp.retrlines(f'RETR {remote_file_name}', append_line)

5. 关闭连接

# 完成所有操作后关闭FTP连接
ftp.quit()

其他常见操作

• 删除远程文件：

ftp.delete('remote_file.txt')

• 新建远程目录：

ftp.mkd('new_directory')

• 删除远程目录（空目录）：

ftp.rmd('directory_to_remove')

• 重命名文件或目录：

ftp.rename('old_name.txt', 'new_name.txt')