eric6 17.12 安装配置指南：Python 3.6 与 PyQt5 版本匹配详解

简介：eric6 17.12 是面向 Python 开发者的开源集成开发环境，专为需要中文界面的用户保留了最后完整支持中文的版本。该安装包适合 Windows 10 环境下的初学者与进阶程序员，可解决英文 IDE 带来的语言障碍，并直接提供源码编辑、调试器、项目管理、Git 版本控制与插件扩展等常用功能。压缩包共 6399 个文件，约 27MB，其中以 py/pyc 源码与字节码文件、html 帮助页面、png 图标资源以及 ui 界面文件为主，同时包含 qrc、ts、qm 等 Qt 资源与翻译文件，便于了解 IDE 内部结构与二次定制。安装前需确认 Python 3 与 PyQt5 环境，压缩包内附有清晰的目录结构和依赖说明，便于快速部署。已有 1094 人学习下载。使用这份安装包，读者可获得完整中文菜单与对话框、稳定的 Python 3 开发环境配置指引，以及涵盖调试、自动补全、代码折叠的开发体验；对于需要保存旧版兼容性或研究国际化界面的用户，也是一份不错的参考资源。

1. eric6 17.12：中文界面的最后一个版本，为什么还值得装

前阵子帮某开发者处理一台旧电脑，他刚从 Python 3.6 升到 3.9，双击 eric6 的快捷方式，界面闪了一下就没了。查日志才发现是版本不兼容，他装的是 eric6 19.x，官方早就把中文翻译从发布包里拆出去了，界面全英文，代码补全行为也变了不少。折腾一圈，我们最后装回 eric6 17.12——这是官方发布包里内置中文语言包的最后一个大版本。对还在用 eric6 教 PyQt、维护老项目的开发者来说，这个版本几乎是绕不开的选择。

eric6 是 PyQt 开发里出了名的全功能 IDE，项目浏览器、调试器、代码补全、Qt 设计器集成一套全带。它跟 PyQt 绑得很紧，版本选错了就是启动崩溃或者控件显示异常的下场。这篇笔记就把 eric6 17.12 的安装过程完整拆开：先讲环境和版本怎么定，再走一遍下载和安装，接着把中文界面和编辑器行为调顺，最后给一份可以照着跑通的验证流程。装过的人能直接跳到避坑章节看，新手照着走也能自己把环境搭出来。

2. 安装前的环境取舍：Python 3.6 和 PyQt5 版本别乱配

2.1 版本红线：为什么推荐 Python 3.6.8

eric6 17.12 发布时对应的是 Python 3.6 时代，官方说明里明确写的是支持 Python 3.6.x。我实际装过的几台机器里，Python 3.6.8 是最稳的，3.7 也能跑但偶尔会冒 deprecation 警告，到了 3.8 以上就会出现真正的兼容问题。很多人图省事直接装最新的 Python，然后问为什么 eric6 起不来，十有八九是这一步埋的雷。

# Windows 下先看当前 Python 版本 python --version # 如果输出的是 3.8 及以上，建议单独装一个 3.6.8 # 多版本共存时用 py 启动器指定 py -3.6 --version

这里我给的建议是：别动系统里原有的 Python，装 3.6.8 用虚拟环境隔离。原因很简单，机器上可能还有别的项目依赖高版本 Python，你把默认解释器换成 3.6，其他项目会跟着遭殃。用 py launcher 或者直接调用 3.6.8 的完整路径，把 eric6 的环境独立出来，后期维护成本最低。

判断版本是否合适的另一个办法是直接看 eric6 源码，安装目录里的eric6.py文件头部有版本兼容检测逻辑。它启动时会读当前解释器版本，如果超过预期范围就直接报错退出，这类报错信息通常是Unsupported Python version。看到这个提示就别硬刚了，换解释器比重试一百遍都有效。

2.2 依赖组件版本：PyQt5 与 QScintilla 的配对关系

eric6 17.12 的界面和编辑器核心分别依赖 PyQt5 和 QScintilla。这两个库跟 eric6 的版本绑定非常紧，PyQt5 装太高会碰到 API 变更，装太低又会缺新特性。我习惯的搭配是 PyQt5 5.10.1 配 QScintilla 2.10.4，这套组合在 17.12 上跑了很多个项目都没出过问题。

pip install PyQt5==5.10.1 QScintilla==2.10.4

固定版本号不是保守，是省时间。PyQt5 从 5.12 开始把部分模块拆了又合，5.15 之后有些旧接口直接移除，eric6 17.12 的代码是照着当时的接口写的，用新版本库必然踩坑。QScintilla 的情况更麻烦，它是独立的编辑器组件，PyQt5 的 wheels 包里不带 QScintilla，必须单独装，而且它的版本要跟 PyQt5 的 Qt 版本对齐，错配的典型症状是QScintilla模块导入成功但编辑控件显示空白。

2.3 用虚拟环境隔离：两条命令的事

不建虚拟环境直接往系统 site-packages 里装 eric6 的依赖，短期没问题，时间长了必乱。尤其是你后面还要装 PyQt5 的其他版本给别的项目用，两个版本的库在同一个环境里互相覆盖，到时候崩了都不好定位。

# 创建 eric6 专用虚拟环境（用 3.6.8 解释器） py -3.6 -m venv D:\dev\venv\eric6 # 激活环境 D:\dev\venv\eric6\Scripts\activate

激活之后命令行前面会出现(eric6)前缀，这时候再执行 pip 命令，所有包都会装进这个虚拟环境里，跟全局环境彻底隔离。Linux 上对应的命令是source /path/to/venv/bin/activate，原理一样。装完不想用的时候直接删掉整个 venv 目录就是后悔药。

3. 下载与安装：源码包手动安装是最稳的路线

3.1 从源码包安装：拿到安装包后先做这三步

网上能下载到的 eric6 17.12 安装包一般是 zip 压缩包，解压之后是一个含有install.py的目录。这个包本身就是源码加安装脚本的组合，不需要再去拉别的仓库。拿到手之后先别急着运行，按顺序做三件事：校验文件完整性、安装依赖、执行安装脚本。

# 1. 解压后进入目录 cd eric6-17.12 # 2. 安装依赖（在虚拟环境里执行） pip install PyQt5==5.10.1 QScintilla==2.10.4 pyflakes autopep8 # 3. 执行安装脚本 python install.py

install.py做的事情比很多人以为的多：它检测当前 Python 版本，把 eric6 的包文件复制到 site-packages，生成启动脚本，还会写一份eric6.ini配置文件到用户目录。有些发行版会提示缺少某个模块，这时候看报错信息就行，缺什么补什么。

这里注意一点：pyflakes和autopep8是 eric6 用来做代码检查和格式化的外部工具。17.12 的界面里能看到对应的菜单项，但实际功能是调用这两个独立工具完成的，不装的话 IDE 相关功能会一直报错。

3.2 pip 安装 eric6 的方式为什么我不推荐

有人会问，能不能直接pip install eric6？答案是可以，但大概率装到的不是 17.12。PyPI 上维护的是最新版本，而 17.12 这种老版本并不总会保留在源里。我试过几次，装出来的是界面全英文的新版，中文语言包选项直接从配置里消失了。

# 不建议这种装法：拿到的往往不是 17.12 pip install eric6

如果你非要用 pip 路线，建议装完之后马上检查版本号：

python -c "import eric6; print(eric6.__version__)"

输出如果不是17.12，就说明源里的包不是我们要的。这时候把 pip 装的那个卸掉，回到源码包路线。源码包安装的另一个好处是目录结构清晰，语言包文件就在安装目录下的eric6/i18n里，后面调中文设置时可以手动确认文件在不在。

3.3 安装后的文件布局和启动方式

装完之后先搞清楚文件装到哪了，后面排查问题全靠这个。Windows 下虚拟环境的 site-packages 里会多出一个eric6目录，里面是主程序代码和子模块；Scripts 目录下会有eric6.exe或eric6-scripts.exe之类的启动入口。Linux 下对应的是 site-packages 和 bin 目录。

# 启动 eric6（虚拟环境内） eric6 # 或者用模块方式启动 python -m eric6

第一次启动时 eric6 会在用户主目录下生成配置文件。Windows 上是%APPDATA%\eric6\eric6.ini，Linux 上是~/.config/eric6/eric6.ini。这个配置文件是 ini 格式，后面调中文、改编码都是直接改这里或者通过 IDE 的设置界面改，两种方式等价。

4. 配置中文界面与编辑行为：三个必调项

4.1 切换中文语言包：界面语言为何默认不生效

装完 17.12 之后打开，界面默认可能是英文。这个年代的老版本安装包有个特点：中文语言包文件在安装目录里躺着，但默认不启用，需要手动设置。语言设置在Preferences菜单下的General选项里，把Language从System切到zh_CN，重启才生效。

# 不想点菜单也可以直接改配置文件 # 在 eric6.ini 中找到 [General] 段 # 写入： # [General] # Language=zh_CN

Language=zh_CN这个值对应的是安装目录eric6/i18n下的zh_CN.qm文件。改成其他值就得保证对应的 qm 文件存在，否则 eric6 会回退到英文。修改配置的时候注意文件编码，eric6.ini默认是 UTF-8 编码，用记事本改容易存成 GBK 导致解析失败，启动后又回英文。

一个容易忽略的细节是 Qt 的翻译文件加载机制。eric6 启动时按Language配置去找 qm 文件，找不到就加载英文内置字符串。所以如果改了配置还是英文，先检查i18n目录里有没有zh_CN.qm，文件在不在、权限能不能读，这两步能解决八成的问题。

4.2 编码与字体：中文显示乱码和方框的根源

中文界面切过来了，写代码时还可能出现中文注释变乱码、编辑区中文字体发虚的问题。乱码多半是编码声明不对，Qt 默认不一定会按 UTF-8 读文件。eric6 的Preferences -> Editor -> Autocompletion旁边有File Handling选项，Default Encoding改成UTF-8，这个设置会影响新建文件的默认编码。

# 在 eric6.ini 的 [Editor] 段里 # DefaultEncoding=UTF-8

字体问题更隐蔽。Linux 上如果你没装中文字体，Qt 会用系统默认字体渲染，出来的字全是方框。Windows 上一般有微软雅黑兜底，但 Linux 服务器环境裸装完必现。装个fonts-noto-cjk就能解决：

# Debian/Ubuntu 系 sudo apt install fonts-noto-cjk

装完字体后在Preferences -> Editor -> Fonts里把字体换成Noto Sans CJK SC，字号 10 或者 11 都行。字体列表是 Qt 运行时扫描的，装完新字体要先重启 eric6 才能在列表里看到。字体的坑不解决，后面不管是写中文注释还是看中文报错信息都是折磨。

4.3 编辑器行为：缩进、自动补全和外部工具

eric6 默认的缩进是 4 空格，但对 Python 来说 Tab 和空格混用是大忌。检查Preferences -> Editor -> General里的Indentation设置，确保Tab Indentation关闭，Indentation Width是 4。这一步看起来不起眼，但实际写代码时如果没设对，复制粘贴一段代码就可能让缩进层级全乱。

自动补全依赖 QScintilla 的底层支持，如果前面 QScintilla 版本没配对，这里会直接卡死。Preferences -> Editor -> Autocompletion里勾上Show Completion和Show Source，补全列表会自动扫描当前文件的符号和导入的模块。这个功能在 17.12 上是能用的，前提是 QScintilla 模块能正常导入。

外部工具关联在Preferences -> Tools里，PyFlakes填 pyflakes 路径，Autopep8填 autopep8 路径。虚拟环境里装的工具路径可以直接写pyflakes和autopep8，因为启动 eric6 前已经激活了虚拟环境，命令能找到；如果在桌面环境直接双击启动，就得写完整路径。这些工具是独立进程，eric6 通过命令行参数调它们，路径写错了菜单点了没反应，但主程序不会崩。

5. 避坑与排查：六条可以少走弯路的记录

5.1 启动报错：ModuleNotFoundError: No module named 'QScintilla'

现象是启动 eric6 时直接报错退出，终端显示找不到 QScintilla 模块。好多人以为 PyQt5 装了就自带 QScintilla，其实它从来不在 PyQt5 的 wheels 包里，需要单独装。原因是安装顺序不对，或者 pip 安装时因为网络问题静默失败了。

解决办法就一条，在激活的虚拟环境里补装：

pip install QScintilla==2.10.4

装完验证一下能否正常导入：

python -c "from QScintilla.Qsci import QsciScintilla; print('ok')"

如果输出ok，启动 eric6 就不会再卡在这了。这个坑在 17.12 上特别容易踩，因为 17.12 发布时 QScintilla 正好在版本迭代期，很多人装的是跟 PyQt5 5.15 配套的新版 QScintilla，导入时接口对不上，还会出现别的类型错误。

5.2 界面全英文：语言包文件存在但没加载

现象是设置了zh_CN中文，重启后还是英文界面。排查顺序按照先文件后配置来：先确认eric6/i18n/zh_CN.qm存在，再确认eric6.ini里Language=zh_CN没有被注释，最后看配置文件是不是被某次异常退出回滚了。

有一次我遇到的情况是解压安装包时用了中文路径，比如D:\软件\eric6-17.12，Qt 的翻译文件加载在 Windows 上对非 ASCII 路径支持不佳。把整个目录挪到纯英文路径再重新安装，问题就消失了。这个坑不多见，但一旦中招非常隐蔽，因为报错信息只是静默回退英文，没有任何提示。

5.3 打开文件乱码：默认编码始终是 ASCII

现象是在 eric6 里打开以前写好的.py文件，中文注释全部显示为乱码。原因是Default Encoding还是默认的 ASCII 或者系统本地编码。Python 3 的源码默认 UTF-8，但 eric6 读取文件时优先听自己配置的编码。

# 检查 eric6.ini 是否生效 grep -n "DefaultEncoding" ~/.config/eric6/eric6.ini

如果这里没有输出，说明配置没写进去。直接在Preferences -> Editor -> File Handling里把Default Encoding改成UTF-8，保存后底部状态栏的编码指示会从ISO-8859-1之类的值变成UTF-8。改完再打开乱码文件，基本就正常了。

5.4 中文输入法打不出字：Linux 下的老毛病

Linux 桌面环境下安装 eric6 后，编辑区无法用中文输入法打中文，敲击键盘没有任何反应，或者只能打出英文。这是 Qt5 应用常见的输入法模块缺失问题，跟 eric6 本身没关系。

# 查看当前输入法模块是否设置 echo $QT_IM_MODULE

如果输出为空或者不是fcitx或ibus，在启动 eric6 前导出一个环境变量：

export QT_IM_MODULE=fcitx

然后从同一个终端启动 eric6，再试输入法。注意这个环境变量是在当前终端会话里生效的，桌面快捷方式启动的 eric6 不会读到，需要改启动脚本或者桌面文件里的环境变量。这个问题我在全新安装的 Linux 机器上每次都遇到，属于必踩坑之一。

5.5 点击调试按钮无反应：外部工具路径断了

现象是点击工具栏的调试按钮，IDE 底部没有任何输出，也不报错。这类问题的排查思路跟之前的 PyFlakes 一样，先看外部工具有没有装，再看路径能不能被找到。

# 确认调试配套依赖 pip list | grep -E "pyflakes|autopep8"

如果显示未安装，补上依赖即可。如果已安装但按钮还是无反应，检查Preferences -> Tools里的路径设置是否还指向旧的解释器路径。虚拟环境重建过一次之后，路径往往会失效。

5.6 项目浏览器不显示文件：工作目录没配对

现象是新建项目后，项目浏览器左侧面板是空的，看不到任何.py文件。原因通常是项目目录设置与实际磁盘路径不一致。在项目属性里检查Project Directory，确保指向文件实际所在的目录，然后重新加载项目。这个不算版本 bug，但新手经常在这里卡很久，以为安装出问题了。

6. 装完怎么验证：跑通一个带中文界面的 Qt 小项目

配置全部完成后，不要急着写大项目，先建一个最小工程验证整条链路通不通。验证分为三层：第一层是确认 eric6 启动和中文界面正常，第二层是确认编辑器能跑带中文注释的 Python 代码，第三层是确认 Qt 窗口能正常弹出来且中文标题不乱码。

# demo.py import sys from PyQt5.QtWidgets import QApplication, QLabel app = QApplication(sys.argv) label = QLabel("中文标题验证") label.setWindowTitle("eric6 17.12 验证") label.resize(200, 100) label.show() sys.exit(app.exec_())

这段代码在 eric6 里新建一个项目，添加该文件，按F2运行。能弹出窗口、标题显示正常，就说明 PyQt5 安装和 Qt 环境绑定没问题。接着看代码编辑器：在文件里输入QL，看自动补全会不会弹出QLabel、QListWidget等候选，这能验证 QScintilla 底层是否工作。最后在代码里随便打个断点，按调试快捷键，能停到行上说明调试器正常。

我从那以后每次装完 eric6，不管换多少台机器，都强制走一遍这个流程：新建项目、写一个带中文的 Qt 最小窗口、触发一次自动补全、设置一次断点。十分钟的时间能把八成问题提前暴露出来，避免真到写项目时才发现自己装的环境根本跑不通。希望能帮到正在折腾的你。

本文还有配套的精品资源，点击获取