openpyxl.utils.exceptions.IllegalCharacterError 错误原因分析及解决办法

最新推荐文章于 2025-05-07 12:16:14 发布

村中少年

最新推荐文章于 2025-05-07 12:16:14 发布

阅读量5.8w

点赞数 50

CC 4.0 BY-SA版权

文章标签： pandas IllegalCharacterError openpyxl exceptions

本文链接：https://blog.youkuaiyun.com/javajiawei/article/details/97147219

Python 专栏收录该内容

19 篇文章

订阅专栏

在使用pandas写excel的时候，可能会出现openpyxl.utils.exceptions.IllegalCharacterError的提示错误。根据提示可以知道是openpyxl模块中的错误。因此需要到相应的代码查看原因，进入python命令行模式，输入如下：

>>> import sys
>>> help('openpyxl')

可得openpyxl模块的路径如下/usr/local/lib/python2.7/site-packages/openpyxl，查看该目录下的cell子目录中的cell.py文件，定位到具体错误代码为：

def check_string(self, value):
    """Check string coding, length, and line break character"""
    if value is None:
        return
    # convert to unicode string
    if not isinstance(value, unicode):
        value = unicode(value, self.encoding)
    value = unicode(value)
    # string must never be longer than 32,767 characters
    # truncate if necessary
    value = value[:32767]
    if next(ILLEGAL_CHARACTERS_RE.finditer(value), None):
        raise IllegalCharacterError
    return value

其中ILLEGAL_CHARACTERS_RE的定义在文件的开头，如下：

ILLEGAL_CHARACTERS_RE = re.compile(r'[\000-\010]|[\013-\014]|[\016-\037]')

这里面的非法字符都是八进制，可以到对应的ASCII表中查看，的确都是不常见的不可显示字符，例如退格，响铃等，在此处被定义为excel中的非法字符。
解决上述错误有两种方法，如下：
1，既然检测到excel中存在[\000-\010]|[\013-\014]|[\016-\037]这些非法的字符，因此可以将字符串中的非法字符替换掉即可，在重新写入excel即可。如下：

text= ILLEGAL_CHARACTERS_RE.sub(r'', text)

2，使用xlsxwriter

import xlsxwriter
outputData.to_excel(outputExcelFilePath, engine='xlsxwriter')

outputData是一个DataFrame，在 xlsxwriter应该也是替换掉非法字符，省去了我们手工操作。

本文为优快云村中少年原创文章，转载记得加上小尾巴偶，博主链接这里。