开发经常会遇到各种字符串编码的问题，例如报错SyntaxError: Non-ASCII character 'ascii' codec can't encode characters in position 0-2: ordinal not in range(128)，又例如显示乱码。

由于之前不知道编码的原理，遇到这些情况，就只能不断的用各种编码decode和encode。。。。。

今天整理一个python中的各种编码问题的原因和解决方法，以后遇到编码问题，就不会像莽头苍蝇一样，到处乱撞了。

下面的python环境都是在2.7，听说在3.X中已经没有编码的问题了，因为所有的字符串都是unicode了，之后装个3.X试一下。

如果不知道什么是decode和encode，建议先看一下：

一、encoding的作用

1.在python文件中，如果有中文，就一定要在文件的第一行标记使用的编码类型，例如 #encoding=utf-8 ,就是使用utf-8的编码，这个编码有什么作用呢？会改变什么呢？

demo1.py

# encoding=utf-8test='测试test'print type(test)print repr(test)

输出：

    
     '\xe6\xb5\x8b\xe8\xaf\x95test'
    

我们通过print把一个变量输出到终端的时候，IDE或者系统一般都会帮我们的输出作转换，例如中文字符会转成中文，所以就看不到变量的原始内容。

repr函数可以看这个变量的给python看的形式，也就是看到这个变量的原始内容

从上面的输出可以看到test变量的str类型，它的编码是utf-8的（怎么知道是utf-8，请看第三部分），也就是的encoding类型

如果我们把encoding改为gbk

demo2.py

# encoding=gbktest='测试test'print type(test)print repr(test)

输出

    
     '\xb2\xe2\xca\xd4test'
    

这样test的编码类型就变为gbk了。

所以这个encoding会决定在这个py文件中定义的字符串变量的编码方式。

而如果一个变量是从其他py文件导入，或者从数据库，redis等读取出来的话，它的编码又是怎样的？

a.py

# encoding=utf-8test='测试test'

b.py

# encoding=gbkfrom a import testprint repr(test)

输出

'\xe6\xb5\x8b\xe8\xaf\x95test'

a.py中定义test变量，a.py的编码方式是utf-8,b.py的编码方式是gbk,b从a中导入test，结果显示test依然为utf-8编码，也就是a.py的编码

所以encoding只会决定本py文件的编码方式，不会影响导入的或者从其他地方读取的变量的编码方式

二、常见报错codec can't encode characters的原因

python的程序经常会报错 codec can't encode characters 或 codec can't decode characters

在python中定义一个字符串，

import sysprint sys.getdefaultencoding() # 输出 asciiunicode_test=u'测试test'print repr(str(unicode_test))

上面的代码会报错

'ascii' codec can't encode characters in position 0-1: ordinal not in range(128)

除了str方法外，如果操作两个都有中文的字符串，也会报错，但是只有其中一个有中文，却不会报错

unicode_test = u'测试test%s{0}'print '%stest' % unicode_test  # 不会报错print '%s测试' % unicode_test  #会报错print unicode_test % 'test'  #不会报错print unicode_test % '测试'  #会报错print unicode_test.format('test') #不会报错print unicode_test.format('测试') #会报错print unicode_test.split('test')  #不会报错print unicode_test.split('测试')  #报错print unicode_test + 'test'  #不会报错print unicode_test + '测试'  #会报错

为什么会这样？

这原因下面再解答，这里先列出这个报错的解决方法：

解决方法是：把系统的默认编码设置为utf-8

import sysreload(sys)sys.setdefaultencoding('utf-8')print sys.getdefaultencoding()unicode_test=u'测试test'

demo3.py

# encoding=utf-8

import sys

reload(sys)

sys.setdefaultencoding('utf-8')

unicode_test=u'测试test'

utf8_test='测试test'

gbk_test=unicode_test.encode('gbk')

#合并unicode和utf-8merge=unicode_test+utf8_testprint type(merge)print repr(merge)#合并unicode和gbkmerge=unicode_test+gbk_testprint type(merge)print repr(merge)print merge#合并utf-8和gbkmerge=utf8_test+gbk_testprint type(merge)print repr(merge)print merge

这里定义三个分别是unicode，utf-8和gbk编码的字符串，unicode_test,utf8_test和gbk_test

1.合并unicode和utf-8的时候，输出：

    
     u'\u6d4b\u8bd5test\u6d4b\u8bd5test'
    

合并的结果的编码是unicode编码。

2.合并unicode和gbk，会报错：

'utf8' codec can't decode byte 0xb2 in position 0: invalid start byte

所以我们可以推测：

在python对两个字符串进行操作的时候，如果这两个字符串有一个是unicode编码，有一个是非unicode编码，python会将非unicode编码的字符串decode成unicode编码，再进行字符串操作

例如合并字符串的操作可以写成以下的function：

def merge_str(str1, str2):    if isinstance(str1, unicode) and not isinstance(str2, unicode):        str2 = str2.decode(sys.getdefaultencoding())    elif not isinstance(str1, unicode) and isinstance(str2, unicode):        str1 = str1.decode(sys.getdefaultencoding())    return str1 + str2

PS:sys.getdefaultencoding()的初始值是ascii

所以，

codec can't encode（decode） characters这个报错是encode或decode这两个方法产生的，而这个方法的参数是sys.getdefaultencoding()。如果用ascii编码对带有中文的字符串进行解码，就会报错。所以修改系统的默认编码可以避免这个报错。

当执行 str 操作时，python会执行 unicode_test.encode(sys.getdefaultencoding()) ，所以也会报错。

3.#合并utf-8和gbk的时候却不会报错，python会直接把两个字符串合并，不会有decode或encode的操作，但是输出的时候，部分字符串会乱码。

demo4.py

# encoding=gbkimport sysreload(sys)sys.setdefaultencoding('utf-8')unicode_test = u'测试test'utf8_test = unicode_test.encode('utf-8')gbk_test = unicode_test.encode('gbk')merge = utf8_test + gbk_testprint type(merge)print repr(merge)print merge

这里文件的encoding是gbk，sys.getdefaultencoding()设置为utf-8，结果是：

    
     '\xe6\xb5\x8b\xe8\xaf\x95test\xb2\xe2\xca\xd4test'测试test����test
    

即gbk的部分乱码了。所以输出的时候会按照sys.getdefaultencoding()的编码来解码。

三、怎么判断一个字符串（string）的编码方式

1. 没有办法准确地判断一个字符串的编码方式，例如gbk的“\aa”代表甲，utf-8的“\aa”代表乙，如果给定“\aa”怎么判断是哪种编码？它既可以是gbk也可以是utf-8
2. 我们能做的是粗略地判断一个字符串的编码方式，因为上面的例如的情况是很少的，更多的情况是gbk中的'\aa'代表甲，utf-8中是乱码，例如�，这样我们就能判断'\aa'是gbk编码，因为如果用utf-8编码去解码的结果是没有意义的

3. 而我们经常遇到的编码其实主要的就只有三种：utf-8，gbk，unicode

   • unicode一般是 \u 带头的，然后后面跟四位数字或字符串，例如 \u6d4b\u8bd5 ，一个 \u 对应一个汉字
   • utf-8一般是 \x 带头的，后面跟两位字母或数字，例如 \xe6\xb5\x8b\xe8\xaf\x95\xe5\x95\x8a ，三个 \x 代表一个汉字
   • gbk一般是 \x 带头的，后面跟两位字母或数字，例如 \xb2\xe2\xca\xd4\xb0\xa1 ，两个个 \x 代表一个汉字
4. 使用chardet模块来判断

import chardetraw = u'我是一只小小鸟'print chardet.detect(raw.encode('utf-8'))print chardet.detect(raw.encode('gbk'))

输出：

{'confidence': 0.99, 'encoding': 'utf-8'}{'confidence': 0.99, 'encoding': 'GB2312'}

chardet模块可以计算这个字符串是某个编码的概率，基本对于99%的应用场景，这个模块都够用了。

四、string_escape和unicode_escape

1. string_escape

在str中，\x是保留字符，表示后面的两位字符表示一个字符单元（暂且这么叫，不知道对不对），例如'\xe6'，一般三个字符单元表示一个中文字符

所以在定义变量时，a='\xe6\x88\x91',是代表定义了一个中文字符“我”，但是有时候，我们不希望a这个变量代表中文字符，而是代表3*4=12个英文字符，可以使用encode('string_escape')来转换：

'\xe6\x88\x91'.encode('string_escape')='\\xe6\\x88\\x91'

decode就是反过来。

转换前后的类型都是string。

还有一个现象，定义a='\x',a='\x0'都是会报错ValueError: invalid \x escape的，而定义a='\a',即反斜杠后面不是跟x，都会没问题，而定义a='\x00'，即x后面跟两个字符，也是没问题的。

2. unicode_escape

同理在unicode中，\u是保留字符，表示后面的四个字符表示一个中文字符，例如b=u'\u6211'，表示“我:”，同理我们希望b变量，表示6个英文字符，而不是一个中文字符，就可以使用encode('unicode-escape')来转换：

u'\u6211'.encode('unicode-escape')='\u6211'

注意encode前是unicode，转换后是string。

在unicode中，\u是保留字符，但是在string中，就不是了，所以只有一个反斜杠，而不是两个。

decode就是反过来。

同理，a='\u'也是会报错的

3. 例子

#正常的str和unicode字符str_char='我'uni_char=u'我'print repr(str_char) # '\xe6\x88\x91'print repr(uni_char) #  u'\u6211'# decode('unicode-escape')s1='\u6211's2=s1.decode('unicode-escape')print repr(s1) # '\\u6211'print repr(s2) # u'\u6211'# encode('unicode-escape')s1=u'\u6211's2=s1.encode('unicode-escape')print repr(s1) # u'\u6211'print repr(s2) # '\\u6211'# decode("string_escape")s1='\\xe6\\x88\\x91's2=s1.decode('string_escape')print repr(s1) # '\\xe6\\x88\\x91'print repr(s2) # '\xe6\x88\x91'# encode("string_escape")s1='\xe6\x88\x91's2=s1.encode('string_escape')print repr(s1) # '\xe6\x88\x91'print repr(s2) # '\\xe6\\x88\\x91'

4. 应用

1. 内容是unicode，但是type是str，就可以使用decode("unicode_escape")转换为内容和type都是unicode

   s1='\u6211' s2=s1.decode('unicode-escape')

2. 内容是str，但是type是unicode,就可以使用encode("unicode_escape").decode("string_escape")转换为内容和type都是str

   s1=u'\xe6\x88\x91' s2=s1.encode('unicode_escape').decode("string_escape")

博文为作者原创，未经允许，禁止转载。