Python连接FTP服务器下载文件时，常常会遇到文件名编码问题，尤其当文件名包含非UTF-8字符（例如GBK编码）时。本文提供解决方案，并附带示例代码。
使用ftplib库连接FTP服务器并获取文件列表时，若服务器文件名使用非UTF-8编码，程序可能报错“'utf-8' codec can't decode byte...”。此问题在跨平台或跨语言环境下常见。
解决方法：
-
服务器默认编码:
ftplib本身不支持直接指定或检测服务器默认编码，需借助其他库或扩展功能。 - 多编码尝试: 预知服务器可能使用的编码（如UTF-8和GBK），逐一尝试解码文件名，直到成功。
-
第三方库:
paramiko等第三方库提供更完善的编码支持和错误处理。 - 升级服务器: 将FTP服务器升级为支持UTF-8编码是长久之计，确保文件名编码一致性。
- 避免特殊字符: 限制上传文件名仅使用ASCII字符，可在上传客户端进行文件名清理或转换。
-
自定义错误处理: 捕获
UnicodeDecodeError异常，尝试其他编码解码，或忽略/替换无法解码的字符。
以下示例代码演示如何使用ftplib库和多编码尝试解码文件名：
立即学习“Python免费学习笔记（深入）”；
import ftplib
def decode_filename(filename, encodings=['utf-8', 'gbk']):
for enc in encodings:
try:
return filename.decode(enc)
except UnicodeDecodeError:
pass
return filename # 所有编码尝试失败，返回原始字节
ftp = ftplib.FTP('ftp.example.com')
ftp.login('user', 'passwd')
dir_list = ftp.nlst('/path/to/directory')
for raw_filename in dir_list:
filename = decode_filename(raw_filename)
print(filename)
# ... 下载文件 ...
ftp.quit()
此方法有效处理FTP服务器文件名编码问题，确保程序正确获取和处理文件列表。 请替换'ftp.example.com'，'user'，'passwd'和/path/to/directory为您的实际FTP服务器信息。 根据实际情况调整encodings列表中的编码。
