彻底解决UnicodeEncodeError与UnicodeDecodeError

字符与字节:计算机存储的一切数据,都是由一系列的01比特序列组成的,包括文本字符、图像、音视频、软件等等。8位01比特序列构成一个字节。而字符就是一个符号,如一个汉字、一个字母、一个标点。
通俗来说,字节是计算机的语言,字符是人的语言。如果想要让人和机器通信交流,就需要进行编码和解码。而编解码的一般套路大概就是:给待编码的目标集合(字符,或者其他任何符号、资源等)给定一个唯一ID,把这个ID对应的二进制保存下来,如此种种。


一、ASCII、Unicode、UTF-8、GBK是个什么鬼

这里引用一下知乎上盛世唐朝的回答,个人觉得还是比较通俗易懂的。

  • 中国人民通过对ASCII编码的扩充改造,产生了GB2312编码,可以表示6000多常用汉字。
  • 汉字实在是太多了,包括繁体和各种字符,于是产生了GBK编码,它包括了GB2312中的编码,同时又扩充了很多。
  • 中国是个多民族国家,各个民族几乎都有自己独立的语言系统,为了表示那些字符,继续把GBK编码扩充为GB18030编码
  • 每个国家都像中国一样,把自己的语言编码,于是出现了各种各样的编码,如果你不安装相应的编码,就无法解释相应编码想表达的内容。
  • 终于,有个叫ISO的组织看不下去了。他们创造了一种编码UNICODE,这种编码非常大,大到可以容纳世界上任何一个文字和标志。所以只要电脑上有UNICODE这种编码系统,无论全球哪种文字,只需要保存文件的时候,保存成UNICODE编码就可以被其他电脑正常解释。
  • UNICODE在网络传输中,出现了两个标准UTF-8UTF-16,,分别每次传输8个比特位和16个比特位。
  • 有了UTF-8,为什么国内还有这么多使用GBK等编码的人?因为UTF-8等编码体积比较大,占用空间比较多,如果面向的使用人群绝大部分都是中国人,用GBK等编码也可以。

一言以蔽之,Unicode和GBK、ASCII同是字符集,用来表示字符(符号),前者的表达能力包括后两者;ASCII是最基本的单字节字符集,可直接存储和传输;而UTF-8只是Unicode字符集的一个标准,一种实现方式而已

参考Unicode 和 UTF-8 有什么区别? - 盛世唐朝的回答 - 知乎

如果用一幅图来表示的话,大概长成下面这样子:

字符与字节的关系

二、encode和decode该用哪一个

编码(encode)就是将字符转化成字节序列的过程。反之,解码(decode)就是将字节序列转换成字符的过程。两者是一个互逆的过程,编码是为了存储传输,解码是为了显示阅读。

1、Python的编码为什么那么蛋疼?

原因有二。

其一是因为Python2使用ASCII字符编码作为默认编码方式,而ASCII不能处理中文。那为什么不用UTF-8呢?因为Guido老爹当年正式发布Python第一个版本的时候是1991年2月,而Unicode是1991年10月发布的。Python出生时,UTF-8还没出生。

其二是因为Python2把字符串的类型搞成两种,str和unicode,以致于大家经常被搞糊涂了。

2、str与unicode

Python2中字符串有str和unicode两种类型。str本质上是一串字节序列,由如下示例代码可以看出,str类型的”心“打印出来的是十六进制'\xe5\xbf\x83'

>>> sys.stdin.encoding
'UTF-8'
>>> sys.stdout.encoding
'UTF-8'
>>> s = '心'
>>> type(s)
<type 'str'>
>>> s
'\xe5\xbf\x83'
>>>

而unicode类型的u”心“对应的unicode符号是u'\u5fc3'

>>> u = u'心'
>>> type(u)
<type 'unicode'>
>>> u
u'\u5fc3'
>>>

实验环境为UTF-8。所以上述三个字节'\xe5\xbf\x83'即是“心”的utf-8编码的字节码。这里简单说明一下这种转换关系。

“心”的Unicode编码为u'\u5fc3'即U+5fc3,在 U+0800 和 U+FFFF 之间,我们把5fc3的二进制编码0101 1111 1100 0011依次替换到1110xxxx 10xxxxxx 10xxxxxx里的 x 位置上,不够的位置用 0 来补足。最终我们得到一串二进制数据11100101 10111111 10000011,即1110 0101 1011 1111 1000 0011,即\xe5\xbf\x83

3、encode与decode的选择

我们要把unicode符号保存到文件或者传输到网络,此时需要进行编码将其转换成str类型,于是Python提供了encode方法,反之,则需要进行decode。

encode

>>> u = u'心'
>>> u
u'\u5fc3'
>>> u.encode('utf-8')
'\xe5\xbf\x83'
>>> 

decode

>>> s = '心'
>>> s
'\xe5\xbf\x83'
>>> s.decode('utf-8')
u'\u5fc3'
>>> 

在实验环境为UTF-8的条件下,字符串s默认用UTF-8进行编码,即s的字节码和u.encode('utf-8')的结果一致。
因此,我们可以得到下图。

image

总之,还是那句话,编码(encode)就是把字符(符号)转换成二进制数据的过程,因此unicode到str的转换要用encode方法,反过来就是用decode方法

encoding always takes a Unicode string and returns a bytes sequence, and decoding always takes a bytes sequence and returns a Unicode string.

另外,由第一节字符与字节的关系我们知道,Unicode编码可以表示所有字符集,包括ASCII和GBK。因此,在使用encode/decode的时候一定要对应上相应的字符集,不然将可能会出现UnicodeEncodeError和UnicodeDecodeError。

三、UnicodeEncodeError和UnicodeDecodeError原因举例分析

UnicodeEncodeError

主要发生在unicode字符串转换成str字节序列的时候。例如,

>>> u = u'心'
>>> u.decode('gbk')

错误日志

UnicodeEncodeError: 'ascii' codec can't encode character u'\u5fc3' in position 0: ordinal not in range(128)

为什么会出现UnicodeEncodeError呢?

因为decode是从二进制数据转换成符号的过程,因此,unicode类型字符串需要先转换成二进制数据,隐式调用了encode方法,并且使用了Python默认的ascii码来编码。而ascii字符集只包含了128个字符,不包括中文字符,因此出现了上述错误。

要解决该错误,则必须指定正确的编码规则来使用encode方法,如GBK。

>>> u = u'心'
>>> u.encode('gbk')
'\xd0\xc4'
>>> u.encode('gbk').decode('gbk')
u'\u5fc3'
>>> 

其中'\xd0\xc4'是“心”字在GBK字符集中的编码(也可以理解为编号ID)。

UnicodeDecodeError

主要发生在str类型字节序列转换成unicode类型字符串的时候。例如,

>>> s = '心'
>>> s.encode('gbk')

错误日志

UnicodeDecodeError: 'ascii' codec can't decode byte 0xe5 in position 0: ordinal not in range(128)

为什么会出现UnicodeDecodeError呢?

因为encode是从符号转换成二进制数据的过程,因此str类型字节序列需要先转换成符号,隐式调用了decode方法,并且使用了Python默认的ascii码来解码。而ascii字符集只包含了128个字符,不包括中文字符,因此出现了上述错误。如果用GBK来解码是否可以呢?比如直接执行s.decode('gbk'),答案是不可以。

要解决该错误,则必须指定正确的编码规则来使用decode方法,如UTF-8。

>>> s = '心'
>>> s.decode('utf-8').encode('gbk')
'\xd0\xc4'
>>> 

参考https://blog.csdn.net/trochiluses/article/details/16825269

而如果涉及到UTF-8和GBK编码的相互转换,则只需遵循下图即可做到正确转换。本质上是借助了字符是不变的,而Unicode字符集中包括了GBK的所有字符这一基本事实。

UTF-8编码和GBK编码的相互转换

为了避免出现UnicodeEncodeError/UnicodeDecodeError或者乱码的问题,encode和decode方法一定要成对使用,并且采用正确的字符集和编解码规则。 最佳实践是,建议采用”三明治“处理思想,仅在”出入口“进行encode/decode操作。

简单总结一下,本文粗略介绍了一下Unicode、GBK、ASCII以及UTF-8之间的关系;明确了字符与字节的关系;举例介绍了Encode/Decode使用时的注意事项;并举例分析了UnicodeEncodeError/UnicodeDecodeError产生的原因;总结了一些经验规则;然而,最重要还是文中的三张图。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容

  • 字符集和编码简介 在编程中常常可以见到各种字符集和编码,包括ASCII,MBCS,Unicode等字符集。确切的说...
    兰山小亭阅读 8,451评论 0 13
  • 在人机交互之字符编码 一文中对字符编码进行了详细的讨论,并通过一些简单的小程序验证了我们对于字符编码的认识。但仅了...
    selfboot阅读 2,281评论 0 2
  • 字符是用户可以读写的最小单位。计算机所能支持的字符组成的集合,就叫做字符集。字符集通常以二维表的形式存在。二维表的...
    刘惜有阅读 8,065评论 2 14
  • 前言 很多程序员对字符编码不太理解,当然平时接触的也不是很多。可能只是大概知道 ASCII、UTF8、GBK、Un...
    ZhengYaWei阅读 1,392评论 0 7
  • 每次去图书馆也没有发现什么,今天去图书馆发现有很多神秘的人在图书馆里面转圈。手里还拿着很多纸,还一直问旁边的人。...
    叶随阳光阅读 125评论 0 0