Flask 中的 Unicode¶
为了提供基本的、无痛的 Unicode 支持, Flask 做了以下假设:
- 你网站上文本编码是 UTF-8 。
- 你在内部对文本始终只使用 Unicode ,除非是只有 ASCII 字符的文字字符串。
HTTP 是基于字节的,不仅是协议,用于定位服务器文档的系统也是这样(即 URI或 URL )。然而,通常在 HTTP 上传送的 HTML 支持很多种字符集,并且需要在HTTP header 中注明。为了避免不必要的复杂性, Flask 假设你发送的都是 UTF-8编码的 Unicode,Flask 会为你完成编码工作,并设置适当的 header。
如果你使用 SQLAlchemy 或类似的 ORM 系统操作数据库,道理也是同样的。一些数据库已经使用传输 Unicode 的协议,即使没有,SQLALchemy 或其它 ORM 也会自动处理好这个问题。
- 只使用 ASCII charpoints (基本是数字、非变音或非奇特的拉丁字母)时,可以使用常规的字符串常量( 'Hello World' )。
- 如果你的字符串里有 ASCII 之外的东西,需要把这个字符串标记为 Unicode字符串,方法是加上一个小写 u 作为前辍(比如u'Hänsel und Gretel' )
- 如果在 Python 文件中使用了非 Unicode 字符,那么需要告诉 Python 使用了何种编码。这里,我再次建议使用 UTF-8 。你可以在 Python 源文件的第一行或第二行写入 # -- coding: utf-8 -- 来告知解释器你的编码类型。
- Jinja 被配置为以 UTF-8 解码模板文件,所以请同时确保你的编辑器使用UTF-8 编码保存文件。
如果你打交道的文件系统或环境不是真正基于 Unicode 编码的话,那么使用 Unicode接口时需要妥善地解码。比如,当从文件系统中加载一个文件,并嵌入到 Jinja2模板时,需要按照文件的编码来解码。这里有一个老问题就是文本文件不指定其本身的编码。所以帮你自己一个忙,限定在文本文件中使用 UTF-8 。
无论如何,转入一个 Unicode 文件,可以使用内置的 方法:
把 Unicode 转换成指定的字符集( UTF-8 ),可以使用 unicode.encode()
方法:
- def write_file(filename, contents, charset='utf-8'):
- with open(filename, 'w') as f:
Vim: 在你的 .vimrc 文件中加入 set enc=utf-8
Emacs: 要么使用 encoding cookie,要么把这段文字加入到你的 .emacs文件:
(prefer-coding-system 'utf-8)
(setq default-buffer-file-coding-system 'utf-8)
-
- 打开 设置 -> 首选项 …
- 选择“新建/缺省路径”选项卡
- 选择“ UTF-8 无 BOM ”作为编码
同样也建议使用 Unix 的换行格式,可以在相同的面板中选择,但不是必须的。