最近,我在把一个 Python 2 的视频下载工具 youku-lixian 改写成 Python 3,并添加了自己需要的 YouTube 支持。
在 Linux 下,事情进行得很顺利:所有的东西都用 UTF-8进行编码。Python 3 里的 str 类型从 2.x 版本的 ASCII 字符串变成了 Unicode 字符串;我移除了原来代码里关于本地编码类型的判断处理部分。程序从抓取的页面上解析出视频标题部分的 Unicode 字符串,直接 print ()显示到标准输出,一切看起来很和谐。
假定我抓取的这个视频标题是中文,叫做“你好,世界”。众所周知,得益于 Python 良好的 Unicode 支持,输出它只需要简单的一句:
print ('你好,世界')
在天杀的 Windows 7下测试这个程序时,麻烦就出现了。如果你想知道我为什么这么说,请继续看下去。
我所不了解的 Windows
去年从学校拿到这台 Dell 笔记本时,Windows 7 自然是预装在上面的。
系统语言已经设置成了英语。很快,我对瑞典语键盘的布局感到极其不适应:它的标点符号位置与英语键盘布局有很大区别,分号、冒号、单引号双引号、斜杠反斜杠这些程序员司空见惯的符号,和美式英语键盘完全不同。于是,我把键盘布局换回了习惯的英语键盘,顺便把控制面板的“区域”选项也一概从瑞典换到了英语/美国。
在很长一段时间里,除了界面是英文以外,它看起来和以往用的中文系统没什么区别:有默认的中文字体,输入法可以添加中文的。我平时用它做的,只有:上网,挂迅雷,拿 IE 登网银,玩 Mirror's Edge,几件事而已。
文件系统是 Unicode 编码的,Web 浏览器是支持 Unicode 的,偶尔用的文本编辑器也是一律设置成 UTF-8 的。而且我们知道,从 Windows 2000 起,Windows 的内码实现是使用 UTF-16LE 的。几乎让人快要忘了还有代码页这么一回事。
可是,如果要在英文 Windows 系统的命令提示符里执行这个简单的输出 Unicode 文本的程序:
#!/usr/bin/env python # -*- coding: utf-8 -*- if __name__ == '__main__': print ('你好,世界')
Python 就会跳出来一段错误:
File "c:\Python32\lib\encodings\cp437.py", line 19, in encode return codecs.charmap_encode (input,self.errors,encoding_map)[0] UnicodeEncodeError: 'charmap' codec can't encode characters in position 0-1: character maps to <undefined>
难道 Python 3 不是支持 Unicode 的吗?难道它不是跨平台的吗?
第一个问题,基本上是对的,Python 3 确实支持 Unicode,这种支持体现在它把所有的 str 字符串都作为 Unicode 处理这件事情上。
第二个问题,不完全,跨平台的可移植性是有条件的。Python 本身是支持 Unicode,但是如果遇上了非 Unicode 的古董环境,那就一点办法也没有。
什么叫“非 Unicode 的古董环境”呢……不,我说的不是 DOS。这个东西,竟然就是 Windows 上的cmd.exe
,每个人或多或少都用过的命令行环境。
cmd.exe
,从 MinGW 到 Python,基本上每个 Windows 下需要接触命令行的开发人员都躲不过去的东西,微软怎么就不能把它做好些?窗口大小不能随心所欲改也就算了,不能全屏显示也就算了,字体大小屏幕缓冲设置各种限制也就算了,鼠标拖拽不方便也就算了,命令行补全补不全也就算了,你好歹能把默认编码改成用 Unicode 吧?一个破窗口从二十年前的 3.x 时代沿用到今天的 Windows 7,从依赖 DOS 的command.com
到独立的cmd.exe
,尼玛这么多年了,也没见功能上有什么实质的改进,是不是在微软眼里所有的程序员都在拿个白花花的 IDE“做你的 code”、不需要命令行了?
(在 Windows 已经完全使用 UTF-16 作为内码实现的今天,cmd.exe
仍然在使用系统默认的代码页,我所能想到的唯一理由就是为了保持和以前的 non-Unicode 程序兼容——不过这理由也太弱了吧)
微软有功夫把 Windows 8 的界面做得花里胡哨,不过看样子他们是压根不打算把cmd.exe
这个东西做得更好用些。不继续喷下去了,说处理问题的经过:
前面 Python 的错误信息里提到了个文件cp437.py
。既然是 cp437 什么的,那就一定是 Python 在试图把 Unicode 字符串转换成用于输出的 437 代码页(英语/美国)时出了错。
为什么 Python 要把一个好端端的 Unicode 字符串转换成 cp437 呢?这很容易想通,因为程序是在cmd.exe
这个终端环境下执行的。在我的英文系统上,它的活动代码页是 437(英语/美国)。从代码中的 Unicode 字符串到输出 cp437 的这一步转换,是由 Python 解释器来实现的,所以会由 Python 抛出一个错误,而不是直接在控制台输出一堆乱码。
首先想到的解决方案,自然是改变当前cmd.exe
的活动代码页到 UTF-8 Unicode:
chcp.com 65001
不幸的是,这导致 Python 解释器直接崩溃了:
Fatal Python error: Py_Initialize: can't initialize sys standard streams LookupError: unknown encoding: cp65001 This application has requested the Runtime to terminate it in an unusual way. Please contact the application's support team for more information. LookupError: unknown encoding: cp65001
搜了一下才发现,Python 3.2 目前并不支持 Windows 上面的 cp65001。话说 65001 代码页不就是 UTF-8 嘛(囧囧囧囧囧)
与其说是不支持,不如说是 bug 更合适些。因为执行之后 Windows 就跳出一个警告框说“python.exe
已经停止响应”了……
于是,试着改变代码页到 GBK:
chcp.com 936
结果却是:
Invalid code page
Windows 声称这是一个无效的代码页。为什么?
编码是什么
好了,暂且忘记cmd.exe
诸如此类令人不愉快的东西,在 IDLE 上试一试。
我不知道有多少 Linux 程序员写 Python 的时候会用到 IDLE。对于这些习惯了终端+文本编辑器的用户来说,IDLE 看起来是个无关紧要的附属品,也许它的定位只是用来帮助初学者入门的一个开发环境?
不过,容易被人们忽略的一点是:IDLE 本身是个跨平台的环境,这意味着它可以无条件支持 Unicode(只要系统上有相应的字体),用它来解释执行程序不必受制于特定终端环境的拘束。这一点在 Windows 上很重要,因为cmd.exe
这玩意实在是太差劲了,所以估计很多人在 Windows 下交互执行 Python 的时候还是会选择 IDLE 的。
进入 IDLE。我们可能要关心一下这个 Windows 系统下面的默认编码方式是什么,Python 3 里面有两个函数:
>>> sys.stdout.encoding; locale.getpreferredencoding () 'cp1252' 'cp1252'
第一个
sys.stdout.encoding
是指标准输出的编码,第二个locale.getpreferredencoding
则是系统本地化设置的编码。两者是有区别的。现在我们看到,它们在当前环境下是相同的,都是默认的cp1252,也就是传说中的“ANSI”代码页。
恩,我们已经知道 IDLE 是一个完全跨平台的环境,所以在 IDLE 上输出 Unicode 字符可以得到和 Linux 环境下同样和谐的结果:
>>> print ('你好,世界')你好,世界
顺便看看“你好,世界”的 UTF-8 编码和 GBK 是什么,如果强制用其他编码方式来解码又会得到怎样的结果(后面也许会用到)。可以看到,5 个全角字符在 UTF-8 编码下是 15 个字节,每个字符占 3 bytes;在 GBK 编码下是 10 个字节,每个字符占 2 bytes。
虽然没有什么实际的意义,不过还是可以注意到:UTF-8 编码的字符是无法用 GBK 解码的,哪怕是乱码有时候也不行,因为可能会出现奇数字节长度,这在 GBK 下不合法;反之 GBK 编码字符亦无法用 UTF-8 解码,因为有无效字符值的存在。
借助 IDLE 看到了“你好,世界”各种编码的详细情况。现在我们可以回到cmd.exe
里面看一看下面这段程序的运行结果了:
#!/usr/bin/env python # -*- coding: utf-8 -*- import sys, locale if __name__ == '__main__': print(sys.stdout.encoding, locale.getpreferredencoding ()) try: print('你好,世界') except Exception as err: print(str (err))
首先通过chcp
确认,cmd.exe
的当前活动代码页是 437(英语/美国),而非 IDLE 里的 1252(ANSI)。这是由于我的 Windows 里对 non-Unicode 程序的区域设置是“英语/美国”的缘故。
程序运行的结果是:
cp437 cp1252 'charmap' codec can't encode characters in position 0-4: character maps to <undefined>
可以看到sys.stdout.encoding
实际上就是当前环境下活动代码页的值。locale.getpreferredencoding ()
没变,仍然是系统默认的 cp1252。
之后抛出的异常是在我们预料之中的,正如此前一样,Python 尝试把 Unicode 字符串转换成 cmd 终端下的 cp437 代码页编码。而中文字符本来就是没有对应的 cp437 编码的,所以 Python 报错。
Google 一下'charmap' codec can't encode characters in position 0-4: character maps to <undefined>
这个错误。在 Stack Overflow 上,有人提到了解决的方法:设置一个叫做PYTHONIOENCODING
的环境变量。
PYTHONIOENCODING 环境变量
所谓的PYTHONIOENCODING
,既可以作为环境变量存在,也可以作为 Python 的命令行参数传递。它用于指定 Python 程序标准输入输出(stdin/stdout/stderr)的编码。(注意这个编码不是指源代码的编码,和 Python 程序开头常见的# -*- coding: utf-8 -*-
是两码事)
在没有这个环境变量时
如前面所述,Python 会试图把内部 Unicode 编码的字符串转化成当前执行程序的终端环境下所使用的编码方式(sys.stdout.encoding
)后输出。对于当前代码页 437 的cmd.exe
来说,把只含有英文数字的字符串转成 cp437 编码没有任何问题;但是一旦遇上了中文字符,英语/美国的 437 代码页里必然是找不到对应的编码的,于是 Python 就会报错。
如果当前代码页设成 65001,Python 3.2 会崩溃,这是本身实现上的问题。在最新的 Python 3.3 beta 中已经增加了对 cp65001 的支持。
在设置了这个环境变量时
通过
set PYTHONIOENCODING=utf-8
或(PowerShell 下)
$env:PYTHONIOENCODING = "utf-8"
PYTHONIOENCODING
指定的编码方式会覆盖原来的sys.stdout.encoding
。如果将PYTHONIOENCODING
设置为 utf-8,那么 Python 在输出 Unicode 字符串的时候就会以 UTF-8 输出,相当于什么也不转换。
再次执行该 Python 程序,这一次 Python 不再尝试自动转换 Unicode 的中文字符到 cp437 中的对应字符,程序成功运行,sys.stdout.encoding
变成了 utf-8,字符串输出则是乱码:
utf-8 cp1252你好,世界
这与我们之前在 IDLE 中将 UTF-8 编码的文本强制用 cp437 解码得到的结果是完全相同的:
>>> print(bytes ('你好,世界', 'utf-8') .decode ('cp437')) Σ╜áσÑ╜∩╝îΣ╕ûτòî
Python 直接把 UTF-8 编码的字符串输出到了 cp437 代码页的终端,相当于强制用 cp437 来解码 UTF-8 文本,产生了无意义的乱码。
用文本编辑器写一个内容是“你好,世界”的文件,以 UTF-8 编码保存。在cmd.exe
下通过 type 显示,结果和上面是相同的。
cmd.exe 和 PowerShell ISE 的微妙之处对比
在当前区域设置(英语/美国)下,两者执行chcp.com
显示的当前活动代码页都是 437。
只有 cmd 下 Python 的sys.stdout.encoding
默认是 cp437(与活动代码页相同);PowerShell ISE 下sys.stdout.encoding
则是 cp1252(ANSI)。
locale.getpreferredencoding
永远是系统本身默认的 cp1252,这是一个系统全局值。
cmd 无法输入中文,不能正确显示文件系统中的中文文件名;PowerShell ISE 能够输入中文,能显示中文文件名。
在缺少 936 代码页的情况下,两者都不能够通过执行脚本或 type 文件内容正确显示中文字符(无论是 GBK 还是 UTF-8),会产生乱码。
为什么 Windows 会缺少 GBK 代码页?
回到最初的那个问题上来,为什么执行chcp.com 936
不能切换到 GBK 代码页?为什么cmd.exe
和 PowerShell 里不能正常显示中文?
这个问题让我百思不得其解。花了几个小时找到了原因,简而言之:因为 Windows 的“区域和语言”设置不对。
“Language for non-Unicode programs”这个选项不是简体中文,所以就不能用 GBK,手动chcp.com
也会告诉你该代码页无效。所以必须要在控制面板里设置成简体中文,重启后才能生效。
好吧,问题来了,为什么这里只能单选?如果我既想使用 936(GBK)编码的应用程序,又想使用 932(日语)编码的应用程序,难道每次都要在这里改完后再重启吗?为什么他们不能给一个详细的代码页列表让用户多选、需要时可以动态加载?
Windows 设计的龌龊之处就在这里。如果你不去设置 system locale 为中文并重启,所有 non-Unicode 程序里的中文字符集都是不会出现的,只能显示成一个方框,比如cmd.exe
里:
还有 Vim 里(set fileencodings=utf-8,gbk
),GBK 编码的文本和 UTF-8 编码的文本都一样无法显示。(按理说 Vim 应该不能算 non-Unicode 程序吧……谁知道呢?!)
改过"Language for non-Unicode programs”为中文并且重启系统之后,Vim 立即显示正常:
再进cmd.exe
,默认活动代码页 936。这段 Python 程序终于也能正确输出了:
也许 Windows 这种蛋疼的设计是因为考虑到英文用户一般不会需要多余的 Unicode 和代码页字符集,这么做可以节省系统启动时间?谁知道呢,Windows 用户不是最喜欢拿所谓的“启动时间快”作为衡量系统性能的指标了吗……
切换到 cp65001(UTF-8 Unicode),PYTHONIOENCODING
设置成 utf-8,按理来说这种方式不应该出问题,但是这输出怎么看都不像是正常(如下图所示)。不想深究到底为什么了,总之 Windows 下面东西的复杂程度以我这种智商是永远都不能够理解的……
Python 除了标准输入输出,还有……
文件名
open ('文件名测试', 'w')
Python 中对文件系统的操作基本上是不受默认编码影响的,只要sys.getfilesystemencoding ()
的结果是 utf-8(现代 Linux)或者 mbcs(现代 Windows NT 系统上)。两者本质上都是 Unicode 编码。
文件输入输出
文件读写不属于标准I/O,因此和环境变量PYTHONIOENCODING
无关。
for c in ['utf-8', 'gbk']: with open ('test_%s.txt' % c, 'w', encoding=c) as output: try: output.write ('你好,世界\n') except Exception as err: print('\nWriting to file using %s:\n' % c, str (err))
由于在 open ()中显式指定了中文编码方式(
encoding='utf-8'
或encoding='gbk'
),输出“你好,世界”这样的中文文本在任何平台上都应该能够得到正确的结果。
然而对于:
with open ('test_default.txt', 'w') as output: try: output.write ('你好,世界\n') except Exception as err: print('\nWriting to file using default encoding:\n', str (err))
由于没有指定编码方式,Python 会自动使用系统默认的编码方式来进行输出。如果系统默认编码是 cp437 或 cp1252,由于中文字符在这些代码页中显然不存在对应值,Python 会抛出一个熟悉的错误:
File "c:\Python32\lib\encodings\cp437.py", line 19, in encode return codecs.charmap_encode (input,self.errors,encoding_map)[0] UnicodeEncodeError: 'charmap' codec can't encode characters in position 0-1: character maps to <undefined>
当然,当系统默认编码为 cp936(GBK)时,无论
output.write ('你好,世界')
还是
print ('你好,世界')
都可以正常工作。因为“你好,世界”这个 Unicode 字符串是可以被完全转换成 GBK 中的对应编码的。
一些总结和思考
虽然 Python 3 使用 Unicode 编码的字符串,但是在跨平台的程序中依然要取得系统的默认编码用于后续处理,因为并不是所有的终端环境都支持全部的 Unicode 字符集:
if sys.stdout.isatty () default_encoding = sys.stdout.encoding else default_encoding = locale.getpreferredencoding ()
无论何时,不要随心所欲地用 print ()向 stdout 输出 Unicode 字符串。如果某个要输出的 Unicode 字符(比如,中文字)在系统默认编码的字符集(比如,代码页 437)上没有,Python 这时就会抛出一个错误。这其实在大部分时候并不是我们想看到的局面,我们总希望即使有时会输出一些无意义的乱码,程序整体上也能正确运行。拿视频下载工具的例子来说,即使由于终端的关系有时无法正确显示视频名称,这问题并不太严重,因为程序总是可以把抓取的视频内容写入正确的文件的。
在程序中获取了系统默认的default_encoding
,我们就可以强制用它来对 Unicode 字符串进行编码,至少避免了 Python 在自动转码过程中可能会抛出的错误——虽然结果可能只是得到一堆乱码。另外一种处理方式是对于这样的字符串,我们决定根本不去输出它们。
我们比较愿意看到的情况是:如果程序会输出且只会输出中文,而你假想中的 Windows 用户群所使用的代码页是 936(GBK)——尽管在程序中使用 Unicode 字符串吧,这样做不会带来任何问题。
但是,如果不能确定要处理的 Unicode 文本会限定在哪个代码页字符集的范围当中:中文?梵文?希伯来文?阿拉伯文?还是……火星文?这个时候就必须考虑到世界上还有“编码方式差异”这回事了。当然,最好的解决方式也许是:告诉用户,去他的代码页,去他的什么 437、500、936、1252……这堆诡异的数字,去他的 Bush hid the facts,扔掉设计上如此糟糕、编码方式如此混乱和不一致的 Windows,转投一个让生活更简单的操作系统吧。