引言

使用 Anaconda 3(conda 4.5.11)的 tkinter python 包(conda install -c conda-forge tk)开发 GUI 界面程序过程中,发现 UI 界面出现的中文 Unicode 乱码一直没办法解决。

  1. #-*- coding: utf-8 -*-
  2. import sys
  3. from tkinter import *
  4. top=Tk()
  5. top.wm_title("菜单")
  6. top.geometry("800x600+300+100") # 创建一个菜单项,类似于导航栏
  7. menubar=Menu(top) # 创建菜单项
  8. fmenu1=Menu(top)
  9. # 如果该菜单时顶层菜单的一个菜单项,则它添加的是下拉菜单的菜单
  10. for item in ['新建文件', '打开文件','结果保存']:
  11. fmenu1.add_command(label=item)
  12. fmenu2=Menu(top)
  13. for item in ['程序设置','程序运行']:
  14. fmenu2.add_command(label=item)
  15. fmenu3=Menu(top)
  16. for item in ['使用教程', '版权信息', '检查更新']:
  17. fmenu3.add_command(label=item)
  18. # add_cascade 的一个很重要的属性就是 menu 属性,它指明了要把那个菜单级联到该菜单项上
  19. # 当然,还必不可少的就是 label 属性,用于指定该菜单项的名称
  20. menubar.add_cascade(label='文件', menu=fmenu1)
  21. menubar.add_cascade(label="程序", menu=fmenu2)
  22. menubar.add_cascade(label="帮助", menu=fmenu3)
  23. # 最后可以用窗口的 menu 属性指定我们使用哪一个作为它的顶层菜单
  24. top['menu']=menubar
  25. top.mainloop()

Python 中 tkinter 中文乱码 - 图1

上面几种方法测试后,问题依然存在。在 google 上一番搜索和来回测试之后,发现了几点信息:

  1. 有人说,可能是 tcl/tk 安装不完整造成的。

  2. tcl/tk 重装后需要对 Python 重新编译 tkinter 才能起作用。

  3. conda install -c conda-forge tk,虽然没有任何报错,python 中 import tkinter 也正常,但 conda 的软件安装就像一个黑盒子,无法确认 tcl/tk 是否完整安装。

  4. python 的 PyPI 仓库中是没有 tkinter 包的,想要使用 pip install tkinter 卸载或者重装都是行不通的。

  5. 网上也有人说可以使用 yum install python3-tk/python-tk 解决,但对于本人来说,没用。

什么是 tcl, tk, tkinter

The tkinter package (“Tk interface”) is the standard Python interface to the Tk GUI toolkit. Both Tk and tkinter are available on most Unix platforms, as well as on Windows systems. (Tk itself is not part of Python; it is maintained at ActiveState.)

Running python -m tkinter from the command line should open a window demonstrating a simple Tk interface, letting you know that tkinter is properly installed on your system, and also showing what version of Tcl/Tk is installed, so you can read the Tcl/Tk documentation specific to that version.

From https://docs.python.org/3/library/tkinter.html

Tcl 是”工具控制语言(Tool Control Language)”的缩写。Tk 是 Tcl “图形工具箱” 的扩展,它提供各种标准的 GUI 接口项,以利于迅速进行高级应用程序开发。

tkinter 包(”Tk 接口”)是 Tk GUI 工具包的标准 Python 接口。 Tk 和 tkinter 在大多数 Unix 平台以及 Windows 系统上都可用(Tk 本身不是 Python 的一部分,它在 ActiveState 中维护)。您可以通过从命令行运行 python -m tkinter来检查 tkinter 是否已正确安装在系统上。如果已经安装该命令会打开一个简单的 Tk 界面,该界面除了让我们知道 tkinter 已正确安装,并且还显示安装了哪个版本的 Tcl/Tk,因此我们可以阅读特定于该版本的 Tcl/Tk 文档。

Python 中 tkinter 中文乱码 - 图2

如果 tkinter 没有安装,则会提示找不到该包(注意在 Python 2 中该包包名为 Tkinter,Python 3 中为 tkinter):

Python 中 tkinter 中文乱码 - 图3

接下来我们将尝试在 Python 2 中安装 Tcl/Tk,并重新编译 python 2,已完成 Tkinter 安装(tkinter 为 Python 的标准库,标准库的安装需要重新编译 Python ?)。

ActiveTcl 安装

ActiveTcl 是 ActiveState 发布的关于 Tcl/Tk 的发行版本,该发行版本包含了最新版本的 Tk 和 Tcl 程序,我们下载其免费的社区版本进行安装即可。

参考下载链接:https://www.activestate.com/products/activetcl/downloads/
参考安装教程:https://tkdocs.com/tutorial/install.html

以下为 CentOS 7 下 ActiveTcl-8.6.8.0 的一些安装记录,仅作参考。

  1. $ wget https://downloads.activestate.com/ActiveTcl/releases/8.6.8.0/ActiveTcl-8.6.8.0-x86_64-linux-glibc-2.5.tar.gz
  2. $ tar zvxf ActiveTcl-8.6.8.0-x86_64-linux-glibc-2.5.tar.gz
  3. $ cd ActiveTcl-8.6.8.0-x86_64-linux-glibc-2.5-28eabcbe7
  4. $ ./install.sh
  5. Welcome to
  6. ActiveTcl Community Edition for Linux/x86_64
  7. Supported Packages:
  8. Tcl 8.6 Thread 2.7.3
  9. Tk 8.6 trofs 0.4.9
  10. Extra Packages:
  11. zlib 1.2.11
  12. libiconv 1.15
  13. ...
  14. Cancel => C
  15. Next => [RET] >> Enter 回车】
  16. ...
  17. Cancel [no] => [RET]
  18. Accept License [yes] => 'A' >> yes
  19. Please specify the installation directory.
  20. Path [/opt/ActiveTcl-8.6]: /usr/local/software/ActiveTcl-8.6
  21. Please specify the directory for the demos.
  22. Path [/usr/local/software/ActiveTcl-8.6/demos]: Enter 回车】
  23. ...
  24. Installing ActiveTcl ...
  25. Installing demos ...
  26. Done ...
  27. Finishing the installation
  28. Patching the shells and libraries for the new location ...
  29. * /usr/local/software/ActiveTcl-8.6/bin/tclsh8.6 ...
  30. * /usr/local/software/ActiveTcl-8.6/bin/wish8.6 ...
  31. ...
  32. For a csh or compatible perform
  33. setenv PATH "/usr/local/software/ActiveTcl-8.6/bin:$PATH"
  34. For a sh or similar perform
  35. PATH="/usr/local/software/ActiveTcl-8.6/bin:$PATH"
  36. export PATH
  37. Some shells (bash for example) allow
  38. export PATH="/usr/local/software/ActiveTcl-8.6/bin:$PATH"
  39. Similar changes are required for MANPATH
  40. Finish >>
  41. Do you want to download a free trial of Komodo IDE? [Y/n]

ActiveTcl 安装完成后,需要把 path 添加至环境变量(~/.bashrc):

  1. export PATH="/usr/local/software/ActiveTcl-8.6/bin:$PATH"

Python 重新编译安装

想要在 Python 2.7 安装 Tkinter,需要在编译过程中通过 --with-tcltk-includes--with-tcltk-libs 中指定 ActiveTcl 的头文件以及库所在路径。

如果在执行编译安装过程中,出现无法找到 libXss.so.1 共享动态库报错:

  1. $ tar zvxf Python-2.7.15.tgz
  2. $ cd Python-2.7.15
  3. $ ./configure --prefix=/usr/local/software/python-2.7 --with-tcltk-includes='-I/usr/local/software/ActiveTcl-8.6/include' --with-tcltk-libs='/usr/local/software/ActiveTcl-8.6/lib/libtcl8.6.so /usr/local/software/ActiveTcl-8.6/lib/libtk8.6.so' --enable-optimizations
  4. $ make
  5. ......
  6. warning: building with the bundled copy of libffi is deprecated on this platform. It will not be distributed with Python 3.7
  7. *** WARNING: renaming "_tkinter" since importing it failed: libXss.so.1: cannot open shared object file: No such file or directory
  8. Python build finished successfully!
  9. The necessary bits to build these optional modules were not found:
  10. _dbm _gdbm
  11. To find the necessary bits, look in setup.py in detect_modules() for the module's name.
  12. The following modules found by detect_modules() in setup.py, have been
  13. built by the Makefile instead, as configured by the Setup files:
  14. atexit pwd time
  15. Following modules built successfully but were removed because they could not be imported:
  16. _tkinter
  17. running build_scripts
  18. ......

CentOS 下请参考以下解决方法:

  1. $ sudo yum install libXScrnSaver libXScrnSaver-devel

调用 Tkinter

Python 2 重新编译完后,执行 python2 -m Tkinter 显示 Tk 的 ui 界面,以及相应的 Tcl/Tk 版本。

Python 中 tkinter 中文乱码 - 图4

这时候,我们重新运行开头的 GUI 界面程序,可以看到中文已经正常显示:

Python 中 tkinter 中文乱码 - 图5


参考资料