Python ftplib 模块：FTP 文件传输的实用指南

tekin

于 2025-03-11 07:00:00 发布

阅读量1.6k

点赞数 31

分类专栏： Python网络编程文章标签： python ftplib

本文链接：https://blog.csdn.net/tekin_cn/article/details/145964087

版权

Python网络编程专栏收录该内容

60 篇文章

订阅专栏

Python `ftplib` 模块：FTP 文件传输的实用指南

在网络数据交互中，文件传输是一项常见需求。Python 的 ftplib 模块提供了一种便捷的方式来实现与 FTP（File Transfer Protocol）服务器的通信，允许我们进行文件的上传、下载、目录操作等。本文将结合 Python 官方文档，详细剖析 ftplib 模块的功能、使用方法、异常处理等方面，同时与其他文件传输方式进行对比，帮助读者全面掌握如何使用该模块完成 FTP 文件传输任务。

文章目录

Python `ftplib` 模块：FTP 文件传输的实用指南

一、`ftplib` 模块概述

ftplib 是 Python 标准库中的一部分，它实现了 FTP 客户端协议，让我们可以在 Python 程序中轻松地连接到 FTP 服务器，并执行各种文件传输和管理操作。该模块的核心类是 FTP，通过创建 FTP 对象，我们可以建立与 FTP 服务器的连接，并调用其方法来完成不同的任务。

二、连接到 FTP 服务器

1. 基本连接

使用 FTP 类创建对象并连接到 FTP 服务器，示例代码如下：

import ftplib

# 创建 FTP 对象
ftp = ftplib.FTP('ftp.example.com')

# 登录服务器
ftp.login('username', 'password')

# 打印欢迎信息
print(ftp.getwelcome())

# 关闭连接
ftp.quit()

2. 连接参数说明

```
FTP(host='', user='', passwd='', acct='', timeout=None, source_address=None)
```
：
- host：FTP 服务器的主机名或 IP 地址。
- user：登录用户名。
- passwd：登录密码。
- acct：可选的账户信息。
- timeout：连接超时时间（秒）。
- source_address：本地源地址和端口。

三、文件和目录操作

1. 查看目录内容

使用 nlst() 方法列出当前目录下的文件和子目录，示例如下：

import ftplib

ftp = ftplib.FTP('ftp.example.com')
ftp.login('username', 'password')

# 列出当前目录内容
files = ftp.nlst()
for file in files:
    print(file)

ftp.quit()

2. 切换目录

使用 cwd() 方法切换到指定目录，示例如下：

import ftplib

ftp = ftplib.FTP('ftp.example.com')
ftp.login('username', 'password')

# 切换到指定目录
ftp.cwd('/path/to/directory')

# 列出新目录内容
files = ftp.nlst()
for file in files:
    print(file)

ftp.quit()

3. 上传文件

使用 storbinary() 方法上传二进制文件，示例如下：

import ftplib

ftp = ftplib.FTP('ftp.example.com')
ftp.login('username', 'password')

# 打开本地文件
with open('local_file.txt', 'rb') as file:
    # 上传文件
    ftp.storbinary('STOR remote_file.txt', file)

ftp.quit()

4. 下载文件

使用 retrbinary() 方法下载二进制文件，示例如下：

import ftplib

ftp = ftplib.FTP('ftp.example.com')
ftp.login('username', 'password')

# 打开本地文件用于写入
with open('downloaded_file.txt', 'wb') as file:
    # 下载文件
    ftp.retrbinary('RETR remote_file.txt', file.write)

ftp.quit()

5. 删除文件和目录

使用 delete() 方法删除文件，示例：ftp.delete('file_to_delete.txt')。
使用 rmd() 方法删除空目录，示例：ftp.rmd('directory_to_delete')。
使用 mkd() 方法创建新目录，示例：ftp.mkd('new_directory')。

四、异常处理

在使用 ftplib 时，可能会遇到各种异常情况，如连接失败、登录失败、文件操作错误等。常见的异常类包括：

ftplib.all_errors：所有 ftplib 异常的基类。
ftplib.error_perm：表示权限错误，如登录失败、文件删除权限不足等。
ftplib.error_temp：表示临时错误，如服务器繁忙等。

示例代码展示异常处理：

import ftplib

try:
    ftp = ftplib.FTP('ftp.example.com')
    ftp.login('username', 'password')
    # 执行文件操作
    ftp.quit()
except ftplib.all_errors as e:
    print(f"FTP 操作出错: {e}")

五、`ftplib` 与其他文件传输方式对比

传输方式	特点	适用场景
`ftplib`	基于 Python 标准库，使用简单；支持基本的 FTP 操作，如文件上传、下载、目录管理。	小型项目中需要与 FTP 服务器进行交互，对传输安全性要求不高。
`paramiko`	用于 SSH 协议的文件传输（SFTP），提供了更安全的传输方式；支持加密和身份验证。	需要安全传输文件，尤其是在企业环境中与远程服务器进行交互。
`requests`	主要用于 HTTP/HTTPS 协议的数据传输；可以处理文件的上传和下载，但不是专门的文件传输库。	通过 HTTP 协议进行文件传输，如从网页下载文件或上传文件到 Web 服务器。

总结

ftplib 模块为 Python 开发者提供了一个方便的工具，用于与 FTP 服务器进行文件传输和管理。通过 FTP 类的各种方法，我们可以轻松地连接到服务器、查看目录内容、上传和下载文件等。同时，需要注意异常处理，以应对可能出现的错误情况。在选择文件传输方式时，应根据具体需求和安全性要求来决定是否使用 ftplib 或其他工具。