Python中zipfile解压中文文件夹名出错怎么办?
开发环境是 ubuntu14 的英文桌面版,开发环境中没有问题。
服务器上是 ubuntu14 的英文 server 版,zipfile 解压文件包,有文件夹是中文名,extractall() 就出错了。
两个环境都是 python3.x,不知道问题出在哪?
Python中zipfile解压中文文件夹名出错怎么办?
连报什么错都不知道,难道能凭空 debug?
八成是文件名编码问题呗。提示:zip 标准默认文件名编码是 cp437
遇到zipfile解压中文文件夹名乱码的问题,通常是因为压缩包使用的编码(如GBK)与Python默认的UTF-8解码不一致。可以通过指定正确的编码来解决。
解决方案:
- 使用
zipfile.ZipFile时,通过metadata_encoding参数指定编码(Python 3.11+)。 - 对于更早的Python版本,可以手动处理文件名编码。
示例代码:
import zipfile
import os
def extract_zip_with_encoding(zip_path, extract_to, encoding='gbk'):
"""
解压包含中文文件名的zip文件
:param zip_path: zip文件路径
:param extract_to: 解压目标目录
:param encoding: 文件名编码,默认为gbk
"""
with zipfile.ZipFile(zip_path, 'r') as zip_ref:
# 获取zip内所有文件信息
for file_info in zip_ref.infolist():
# 尝试使用指定编码解码文件名
try:
# 对于Python 3.11以下版本,手动处理编码
original_filename = file_info.filename
corrected_filename = original_filename.encode('cp437').decode(encoding)
except (UnicodeEncodeError, UnicodeDecodeError):
# 如果编码失败,保留原始文件名
corrected_filename = file_info.filename
# 更新文件名信息
file_info.filename = corrected_filename
# 解压文件到目标目录
zip_ref.extract(file_info, extract_to)
# 使用示例
extract_zip_with_encoding('你的压缩文件.zip', '解压目标文件夹', encoding='gbk')
关键点说明:
cp437是zip文件存储文件名时常用的默认编码。encoding参数需要根据压缩包的实际编码调整,常见的有'gbk'、'gb2312'或'utf-8'。- 如果压缩包是在Windows系统创建的,通常使用
'gbk'编码。
一句话建议: 指定正确的文件名编码参数即可解决乱码问题。
看源码 一个一个文件解压
把 python 版本降到 3.4 试试看,我在 ubuntu14 上也遇到过类似的问题,后来通过降版本号解决了
我知道是什么错误:就是文件名编码的问题。我是征对性的测试,只是奇怪本地环境和 server 环境一样,server 上中文名会编码通不过,比较奇怪。
老外大神都是英文文件名,根本遇不到这种 bug (_)
是啊,看了源码,zipfile 默认 cp437 和 utf-8,try 了一下 cp437,error 就用 utf-8。没有参数可以设定。要是中文名 gb2312 都不知道怎么 encode
要是文件名编码 gb2312,那就 file_name.encode(‘cp437’).decode(‘gbk’) 即可。zipfile 没有提供选项,需要自己处理。如果能 extractall() 成功,就自己改名字。如果不能 extractall(),就用 ZipFile.open() 自己处理文件内容和文件名。
在本地开发环境,可以 extractall()成功;在 Server 环境 extractall()不成功,系统没办法识别中文文件夹和文件名。
感觉奇怪的就是在这个地方。因为 extractall()都没有设置选项,本地可以成功 extract all,说明只要环境设置 OK 就能解析中文文件名,就可以。只是我没发现这个环境设置参数是哪个,所以 Server 上出错,就不知道改哪个地方啦。
也许是 locale 没设置好?
试试 export LC_ALL=“zh_CN.UTF-8” 怎么样?
先用 locale 看下是否一致,
zip 标准太老,根本没有考虑编码。咋办?
1. 调用外部 7z 或 unar 来解压
2. 提前用 iconv 把文件名编码换成 utf-8
3. 用第三方库,目前我没发现 Python 3 可以用的
吐槽:你知道报错信息,看帖的不知道啊
是的,我试过改 locale 的设置,重启之后,python 测试:
import locale
locale.getpreferredencoding()
locale.getdefaultlocale()
开发环境是:
UTF-8
(‘en_US’, ‘UTF-8’)
server 环境是:
ANSI_X3.4-1968
(None, None)
看起来,就是 defaultlocale 没生效。
我用了不同的编码专门去测试哪一行 extractall()的运行结果,记录日志,英文的都能正确运行通过,所以知道是那一行运行错误,只是不知道怎么正确 debug 了
你好!我也遇到一个类似的解压问题,可以给个联系方式交流下么?

