简介：这是专为中文用户打包的 eric6 17.12 安装包，也是官方最后完整支持中文界面的版本。面向需要中文环境的 Python 开发者，可有效降低菜单、配置与插件的语言门槛；内置源码编辑器、调试器、项目管理、Git 集成和插件系统，支持语法高亮、代码折叠、自动补全、断点调试等日常操作，适合从新手到中级开发者使用。压缩包共 6399 个文件，约 27.03 MB，以 Python 源码 py/pyc 为主，配合界面模板 ui/qrc/ts、说明文档 html/txt/md、图标资源 png/ico 以及 xml/qch 等辅助文件；pyc 可加快启动，qm/ts 翻译文件便于核对中文显示，ui/qrc 适合二次定制界面布局，帮助文档可离线查阅。目前已有 1094 人学习/下载，适合刚接触 eric6 或希望在旧版本中保留中文菜单的开发者存档使用。通过该包可一次获得完整安装目录结构、内置 API 描述、示例配置与多语言资源，便于离线安装、二次调整或学习 IDE 各模块的组成，是中文 Python 开发环境中一份难得的完整快照。
1. eric6 17.12：为什么这款老 IDE 仍是中文开发者的实用选择
如果你用过 eric6 17.12，大概率会记住它的中文菜单和代码补全弹窗没有半个乱码。这个版本之后，eric6 的中文界面支撑开始变得不稳定，不少同学装上 18.x 后发现菜单变回了英文，甚至直接启动失败。于是 17.12 成了公认的“支持中文的最后版本安装包”，也是很多中文开发者装完不再升级的钉子户版本。
这篇文章适合两类人：一类是刚接触 PyQt5，想找个开箱即用的 IDE 写小程序；另一类是维护老项目，必须复现当年的中文开发环境。我会把安装环境怎么搭、中文配置怎么调、哪些版本组合会让你翻车，以及我实际踩过的坑都写清楚。先说明一点：它不是最新版本，也不支持 Python 3.9 以上，但如果你需要的是稳定、顺手、界面全中文的 PyQt 开发环境，这个版本依然是值得留一份的备选。
2. 安装前的准备工作：Python 版本、PyQt5 与 Qt 工具链的匹配
2.1 为什么 17.12 绑定了特定版本的运行环境
eric6 的界面本质上是 PyQt5 程序。编辑器、调试器、代码补全窗口，全是 Qt 控件拼出来的。这意味着 IDE 本身的运行依赖 Python 解释器和 PyQt5 的版本。17.12 发布时，主流是 Python 3.5/3.6 和 Qt 5.10 那一段，配套的 PyQt5 也是 5.10.x 一代。开发环境如果不匹配，最常见的后果是启动直接报错，或者菜单能开但代码补全失灵。
我见过有人拿 Python 3.12 去跑 17.12，安装脚本能跑完，但一启动就提示 sip 模块导入失败。原因很简单：pyqt5 的二进制接口和 Python ABI 不匹配，PyQt5 5.10.x 根本找不到适配 Python 3.12 的 wheel。与其折腾这些，不如一步到位装回 Python 3.6.8。这个版本兼容性好，网上资料也最多，遇到问题还能查到老帖子。
注意：安装 eric6 17.12 前，先把 Python 3.6 装好并加入 PATH，不要先装新版 Python 再回头装旧版解释器，venv 的路径会越搞越乱。
2.2 下载安装包并搭建基础环境
拿到 eric6 17.12 的源码包后，解压到任意目录，比如D:\eric6-17.12。里面会有install.py、eric6.py、i18n目录等。源码包方式安装比 exe 安装更透明，改配置也方便，我一般都用这个方式。
先把基础环境装齐，以下命令在 Python 3.6.8 的命令行里执行：
python -m pip install --upgrade pip python -m pip install PyQt5==5.10.1 python -m pip install pyqt5-tools python -m pip install pyenchantPyQt5 指定 5.10.1，是因为这一版和 eric6 17.12 的搭配最稳。pyqt5-tools提供 Qt Designer 等图形工具，做界面设计时需要它。pyenchant是拼写检查组件，不装也能运行，但代码注释里的英文拼写会少了自动提示。
装完后，在同一个终端里启动 Python 验证一下导入是否正常：
# 验证 PyQt5 能否正常导入 from PyQt5.QtCore import QT_VERSION_STR from PyQt5.Qt import PYQT_VERSION_STR print("Qt 版本:", QT_VERSION_STR) print("PyQt5 版本:", PYQT_VERSION_STR)如果能正确输出版本号，说明 PyQt5 已经可用。注意这里我特意区分了 Qt 版本和 PyQt5 版本：QT_VERSION_STR输出的是 Qt 框架版本，PYQT_VERSION_STR才是 PyQt5 这个包装层的版本。两者不一致很容易导致 eric6 的某些插件加载失败。
2.3 环境变量的检查与验证
装完之后，把安装目录也加进环境变量，方便以后在任意路径直接启动。常规做法是把 Python 3.6 的Scripts目录和 eric6 的目录都加进用户 PATH。
set PYTHONHOME=D:\Python36 set PYTHONPATH=D:\Python36\Lib\site-packages set PATH=%PATH%;D:\Python36;D:\Python36\Scripts;D:\eric6-17.12这里有个容易翻车的点：PYTHONPATH不要往里面塞 eric6 的根目录，除非你打算让 IDE 插件去全局搜索。如果设置错了，之后创建项目时会把一堆模板文件误识别为可导入模块，项目树会变得极其臃肿。正确做法是只保留 Python 标准库路径，eric6 自己的源码通过安装脚本写入它的插件目录。
全部配置好以后，在命令行直接输入python D:\eric6-17.12\install.py执行安装脚本，它会自动往 Python 的site-packages里写入 eric6 的启动入口。这一步做完，才算真正把 eric6 和 Python 环境关联起来。
3. 在 Windows 上部署 eric6 17.12：安装流程与首次启动
3.1 安装包的内容与安装方式
eric6 17.12 的安装包解压后，核心文件数量不多，但分工明确。eric6.py是主程序入口，install.py是安装脚本，uninstall.py是卸载脚本，i18n目录里放着各国语言的翻译文件，其中eric6_zh_CN.qm就是中文界面资源。把这几个文件之间的关系搞清楚，后续出了问题才知道该去哪里找原因。
Windows 上推荐用源码包方式而不是 exe 方式，原因有两点。第一，exe 安装器会往注册表写东西，换 Python 版本后可能留下残留项；第二，源码包方式安装时可以指定安装路径，方便迁移。具体执行安装命令：
cd D:\eric6-17.12 python install.py --bindir D:\eric6-17.12参数--bindir指定可执行文件的输出目录。安装完成后，目录下会多出一个eric6.exe（或者eric6.bat）。打开这个 exe 的方式有个讲究：不要双击文件图标，应该先打开命令行，输入activate激活虚拟环境（如果你用了虚拟环境），再运行eric6.exe。直接双击很多时候会因为目录环境变量没加载而报“缺少 DLL”的错误。
3.2 首次启动与工程创建
首次启动时，如果中文界面没有立即出现，进设置 → 首选项 → 界面 → 语言，把语言改成zh_CN，然后重启 IDE。这一步是很多中文版安装包装完却仍然是英文界面的主要原因：安装包确实带了中文翻译文件，但默认语言没有强制切换。
创建项目时，我建议走工程 → 新建工程，而不是直接新建文件。eric6 的工程文件是.e4p，它会统一管理源码文件、表单文件和翻译文件。如果只新建脚本文件而不建工程，后续在工程浏览器里看不到界面文件，而且 Qt 资源文件.qrc的路径引用会出问题。
# 启动 IDE D:\eric6-17.12\eric6.exe启动后先建一个测试工程，点启动按钮旁边的下拉箭头，选择运行时自动保存，再把调试器 → 设为异常断点勾上。这两项配置能大幅减少早期调试时的摩擦：编辑器崩溃时不会丢代码，异常抛出让调试器直接中断。
3.3 把默认代码补全切换成中文状态
eric6 的代码补全功能依赖 QScintilla 组件，默认情况下它只会对 ASCII 字符触发补全弹窗。很多中文开发者抱怨“补全不管用”，其实是变量名用了中文或拼音开头，触发不了默认的补全条件。在设置 → 编辑器 → 自动补全里，把触发字符从默认的._改成._abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ，中文输入后按.也能触发提示。
中文变量名的处理也比英文麻烦。.e4p工程文件默认用 UTF-8 编码存储，但某些 Windows 老版本系统控制台的代码页是 GBK，导致工程文件里的中文路径显示成乱码。解决方法是把工程文件保存为 UTF-8 with BOM，这个选项在设置 → 编辑器 → 文件 → 文件编码里可以改。改了以后，跨机器拷贝工程时不易出现中文注释乱码。
# 一个简单的 PyQt5 窗口，用于验证 IDE 代码补全 import sys from PyQt5.QtWidgets import QApplication, QLabel app = QApplication(sys.argv) label = QLabel("中文界面测试") label.show() sys.exit(app.exec_())把这个文件存成test_dialog.py，在 eric6 里打开，输入QL应该会弹出QLabel等候选词。如果弹不出来，检查 QScintilla 模块是否完整，常见原因是 PyQt5 安成了精简版，缺少 QScintilla 的绑定。
4. 中文界面配置与汉化细节：不止是切换语言
4.1 语言包的加载机制
eric6 的汉化机制比简单的“界面语言设置”更深一层。它在启动时先扫描i18n目录，找到eric6_zh_CN.qm文件，然后通过QTranslator加载到 Qt 的语言系统中。如果你用的是源码包且没有执行install.py，翻译文件不会被复制到 eric6 的安装目录，界面上语言列表里可能根本没有zh_CN选项。
出现“语言列表里没有中文”时，优先检查安装目录下是否存在.qm文件：
dir D:\eric6-17.12\i18n\*.qm如果只有.ts文件而没有.qm，说明语言包没有被编译。这大概率是下载的安装包被精简过。解决办法是装一个完整版，或者用 Qt 自带的lrelease工具把.ts编译成.qm。不过正常下载的 17.12 完整包不会出现这个问题，这类情况多见于某些第三方分流包。
4.2 常见的中文乱码问题与编码处理
即使主界面是中文，代码编辑器里依然可能出乱码。最典型的是在 Windows 控制台运行 Python 脚本时，print("中文")输出变成乱串。这要分两层解决：一层是编辑器保存文件的编码，一层是运行时的标准输出编码。
编辑器里的乱码，通过设置 → 编辑器 → 文件 → 默认编码，选 UTF-8 可以解决。运行时输出乱码则要改 Python 的启动环境：
set PYTHONIOENCODING=utf-8把这一行加进 eric6 的启动批处理脚本里，或者在设置 → 调试器 → Python → 环境变量中追加。注意只改 IDE 的语言设置并不能影响子进程的编码行为，很多同学在这上面耗了几个小时，最后发现是控制台代码页的问题。
工程文件里的中文路径乱码是另一个高发区。.e4p文件本质是 XML，内部用QSettings写入路径。如果系统区域设置是“中文(简体, 中国)”，QSettings默认会写 GBK 编码的 INI 格式文件。修改方法是在设置 → 工程 → 工程文件格式里把生成格式改为XML，并明确指定 UTF-8 编码。这个开关改完，工程文件就能在 Linux 和 Windows 之间相互拷贝而不乱码。
4.3 界面字体与中文显示优化
中文菜单字体发虚，几乎是 Windows 上所有 Java 之外 GUI 程序的通病。eric6 17.12 默认使用的字体是 Sans Serif，在中文系统上会退化成宋体或微软雅黑，很多用户觉得“刺眼”。在设置 → 界面 → 字体里，统一改成微软雅黑 10pt，能明显改善观感。
代码编辑区的字体也要单独设置。我习惯用等宽的 Noto Sans Mono CJK SC，因为它在中文注释和英文代码混排时不会出现基线错位。不过这个字体需要额外安装，不想装字体的话，推荐用系统自带的 Consolas 搭配“使用默认中文回退字体”选项。这个选项在 Qt 5.10 里有专门的开关，不勾选时中文注释会被强制渲染成衬线字体，看起来像夹杂了几处日文。
# 查看当前区域语言设置是否会影响 Qt 的字体渲染 python -c "from PyQt5.QtCore import QLocale; print(QLocale().name())"输出应该是zh_CN。如果是en_US，说明系统区域设置被改过，需要到控制面板的“区域 → 管理 → 更改系统区域设置”，勾选“Beta 版: 使用 Unicode UTF-8 提供全球语言支持”。这个选项关闭时，Qt 的中文渲染偶尔会退回到 GBK 字体集。
5. 避坑指南：安装与使用中遇到的高频问题
5.1 安装了却启动不了
- 现象：双击
eric6.exe后没有反应，任务管理器里也看不到进程。 - 原因：PyQt5 的
Qt5Core.dll无法被加载，通常是因为系统中已经装了新版 Qt 的运行时，DLL 版本冲突。另一个常见原因是 Python 环境的sip.pyd和你安装的 PyQt5 版本不一致。 - 解决：在命令行里执行
python -c "from PyQt5.QtCore import QCoreApplication"，如果报错说明 PyQt5 有问题，重装PyQt5==5.10.1。如果导入正常，检查 PATH 里是否混入了 Anaconda 或新版 Python 的路径，把 PATH 精简到只保留 Python 3.6 的目录。
5.2 安装时提示ModuleNotFoundError: No module named 'PyQt5.QtWebEngineWidgets'
- 现象：执行
install.py时在导入 WebEngine 相关模块处中断。 - 原因：PyQt5 5.10.x 的可选组件很多，默认 wheel 并不包含 WebEngine。eric6 的内置帮助浏览器依赖这个模块。
- 解决：单独安装对应版本的 WebEngine 组件。在 Python 3.6 和 PyQt5 5.10.1 的组合下，执行
pip install PyQtWebEngine==5.10.0。装完后再跑install.py，这次能顺利通过。
5.3 打开工程时所有中文文件名显示问号
- 现象：工程浏览器里文件列表正常，但保存、重命名对话框里的中文文件名变成
????。 - 原因：
QFileDialog在非 Unicode 代码页下会使用系统 ANSI 编码解析路径。当系统代码页是 CP936 但 Python 的内部字符串是 Unicode 时，部分对话框控件没有正确转换。 - 解决：在 eric6 的启动参数里追加
--set-filesystem-encoding=Utf-8。这个参数是 Qt 5.10 提供的，可以强制文件系统编码为 UTF-8，避开 Windows ANSI 路径的坑。需要注意的是，这个参数只对 eric6 自身启动的对话框生效，外部插件里自定义的文件对话框还是要单独设置。
5.4 代码补全列表里只剩英文单词，中文变量不出现
- 现象：定义了
用户名这个变量，输入用之后补全列表空白，但输入user就能匹配。 - 原因：QScintilla 的补全触发策略默认按 ASCII 字符顺序分词，中文变量被当作非法标识符忽略。
- 解决：除了在首选项里扩展触发字符外，还要更新
设置 → 编辑器 → 自动补全 → 补全来源，选中“所有缓冲区”。同时把API 文件的编制方式改成“从文档字符串生成”，这样中文注释里出现的名词也能进入补全候选。
5.5 调试器断点不生效，每次都是全速跑完
- 现象：在代码行号旁边点了红点，按 F5 调试，程序直接执行到结束，红色断点没有命中。
- 原因：调试器默认的调试后端是
debugger，但 eric6 17.12 对 Pyside6 或新版 PyQt5 的调试支持有兼容缺口，断点事件根本没传回 IDE 前端。 - 解决：
设置 → 调试器 → Python → 调试器后端，确保选的是“内置调试器”。如果你的工程里有__main__.py且同时存在多个入口脚本，右键项目属性，把启动脚本明确指定为当前要调试的那个文件。多重入口时，调试器很容易绑定到错误的启动脚本。
6. 进阶技巧：让老版本 IDE 在新系统上流畅运行
6.1 用虚拟环境隔离开发环境
先说说虚拟环境。不建虚拟环境直接装，Python 3.6、PyQt5、eric6 全局混在一起，一旦系统里还有其他项目依赖新版 PyQt6，会有很多隐藏的 DLL 冲突。我通常在项目目录下建一个运行环境：
python -m venv D:\projects\pyqt_env D:\projects\pyqt_env\Scripts\activate pip install PyQt5==5.10.1 pyqt5-tools pyenchant D:\eric6-17.12\install.py --bindir D:\projects\pyqt_env\Scripts关键点是最后一步：把 eric6 的启动入口装进虚拟环境的Scripts目录，这样每次激活虚拟环境后直接输入eric6即可启动，不会误调到全局环境。虚拟环境里安装 PyQt5 时，pip 会自动拉取对应 Python 3.6 的sip版本，省去手动配sip.pyd的麻烦。
6.2 高 DPI 屏幕下的界面缩放调整
新版 Windows 在 150% 缩放下，老版 Qt 应用经常出现模糊或者控件错位。eric6 17.12 基于 Qt 5.10，默认没有启用高 DPI 缩放，需要手动设置环境变量。在启动脚本里加入：
set QT_AUTO_SCREEN_SCALE_FACTOR=1 set QT_SCALE_FACTOR=1.25QT_AUTO_SCREEN_SCALE_FACTOR=1让 Qt 根据系统 DPI 自动调整渲染分辨率；QT_SCALE_FACTOR=1.25是手动兜底，防止自动检测在某些驱动上失效。这两个变量同时设置时，Qt 会优先用自动缩放，手动值作为异常情况下的备选。配置完后重启 eric6，界面不会再出现菜单栏窄、代码行距不对称的情况。
6.3 常用调试技巧与快捷键
日常调试中，我依赖这组固定习惯：按 F9 切换断点，F5 开始调试，F6 单步执行，F7 进入函数内部。eric6 的调试视图里有个“变量查看器”，默认只显示当前帧的局部变量。需要监听全局变量时，在变量查看器右键选择“添加全局变量”，填入变量名即可。相比每次切到控制台手动print，这个功能更适合追踪状态变化频繁的 PyQt 信号处理器。
遇到 Python 解释器崩溃，先看D:\projects\pyqt_env\Scripts\eric6.bat生成的日志文件，路径在用户目录下的.eric6\logs。这个目录里存着 IDE 自身的错误堆栈，很多补全和插件问题都能从里面找到根因。我从那以后每次安装完都会强制走一遍 2.3 节的环境变量验证，再拿 5.1 节的导入测试做回归。希望这份 17.12 的部署经验能帮你在新系统上找回顺手的中文开发环境。
本文还有配套的精品资源，点击获取
