简介一份面向中文用户的 Python 集成开发环境安装包适用于 Windows 10 平台内置对中文界面的完整支持解决了官方后续版本对中文支持不完善的问题。压缩包共含 6399 个文件其中 py 源码与 pyc 编译文件用于程序运行与源码回溯html 与 png 构成帮助文档和图标资源ui 文件定义图形界面布局另有 xml、ts、qm 等翻译与配置辅助文件整体约 27.03MB便于快速下载部署。已有 1094 人学习下载。该版本提供语法高亮、代码折叠、自动补全的编辑器内置调试器支持设置断点、单步执行与变量查看同时集成项目管理支持多项目切换、Git 版本控制及插件系统可扩展个性化功能可满足日常 Python 开发全流程需求部署时需先安装 Python 3 与 PyQt5/PyQt5-tools解压后即可使用。作为最后支持中文的发行版适合需要稳定中文 IDE 的初学者与中级开发者。1. 为什么 eric6 17.12 至今还有人找它是中文用户最后的“顺手版本”这些年我拆过不少 Python IDE 安装包但隔三差五总有人回来找 eric6 17.12 这个版本。它的定位很明确一个基于 PyQt5 的跨平台 Python IDE自带编辑器、调试器、项目管理和 Qt 设计器集成而 17.12 这个 2017 年末的版本被社区普遍认为是中文环境下最“顺手”的最后一版。所谓“支持中文的最后版本”更准确的说法是后续版本在字体渲染、编码默认策略和汉化资源上反复调整老用户觉得越来越不对味于是 17.12 变成了很多人收藏夹里的固定资源。这篇笔记我会带你从头理清它的选型理由、安装步骤、参数配置和那些不查文档根本想不通的坑最后给出一套可以直接验证的落地方式。2. 装之前先搞明白四件事版本匹配、依赖顺序与两个必须规避的默认值2.1 Python 版本不是越新越好3.6.x 才是 17.12 的舒适区eric6 17.12 发布时对应的 Python 主流版本是 3.5 和 3.6内部很多组件尤其是调试器与自动补全模块对 Python 3.7 之后引入的部分语法解释并不友好。我实际测试下来在 Python 3.6.8 下运行最稳定在 Python 3.8 以上环境启动时即使依赖库版本强行匹配成功调试器也偶发断点失效的情况。另外一个隐藏问题是 pip 本身。17.12 的年代 pip 还停留在旧依赖解析逻辑今天的新版 pip 在安装老版本 PyQt5 时可能会自动把依赖解析到不兼容的新版本导致装完报错。所以我的习惯是先装 Python 3.6.8再在虚拟环境里锁住 pip 版本为 20.x最后再装 eric6 依赖。2.2 依赖安装顺序有讲究先 PyQt5再 QScintilla最后才考虑装插件很多人拿到安装包后直接用安装器一把梭结果启动时报缺失模块。其实 eric6 本体更像一个 Python 应用框架它运行在 PyQt5 和 QScintilla 之上这两个都是必须的独立依赖。安装顺序我建议是# 在 Python 3.6 虚拟环境中依次执行 pip install PyQt55.10.1 pip install QScintilla2.10.8 pip install pyqt5-tools5.9.0.1.2第一行锁定 PyQt5 版本为 5.10.1这是与 eric6 17.12 配合度最高的版本第二行安装 QScintilla它负责编辑器核心的代码高亮与自动补全展示第三行是 Qt 工具集包含 Qt Designer 等设计器组件。如果不一次性装完启动时大概率会在from PyQt5.QtSvg import ...或import QScintilla处直接抛异常。2.3 默认编码和字体必须提前改否则第一行中文注释就翻车17.12 默认的源文件编码是 UTF-8这在纯英文环境没问题但国内用户拿到手的旧项目很多是 GBK 编码保存的。直接打开时中文注释全会变成乱码。注意这个版本不会像新版那样自动嗅探编码它默认按配置逐字解码配置不对就乱给你看。字体方面默认等宽字体在中文场景下会触发 Qt 的字体回退机制严重时中文直接显示为方框。我一般会在一开始就进Preferences - Editor - Fonts把默认字体改成系统中文字体如SimHei或SimSun并关闭“使用等宽字体渲染中文”选项。这一步不做后面写注释、读日志全是折磨。2.4 安装包与免安装版的取舍我推荐你用哪个这个资源通常包含两种形式一类是安装向导版自动写注册表和快捷方式另一类是绿色免安装版解压即用。我的建议是如果你手里还有旧项目要维护用安装版如果只是体验或临时跑脚本用免安装版。原因在于安装版注册了.pyw和.py的文件关联双击脚本会直接唤起 eric6省去每次手动拖文件进编辑器的操作。免安装版则完全隔离适合放在 U 盘里插到别的机器上用不会污染目标机器的 Python 环境。两种形式的核心代码完全一样配置也都写在用户目录的.eric6配置文件里切换成本很低。3. 零基础复现从空目录到双击运行的第一个中文界面3.1 Python 3.6 环境准备与虚拟环境隔离先说明一个反直觉点eric6 17.12 不适合直接用系统全局 Python 跑。全局环境里的 site-packages 往往已经被装了一堆新版本库把 PyQt5 锁旧会引发连锁反应。用venv隔离是最省心的方案。# 假设 Python 3.6 安装在 /path/to/python36创建一个项目目录 cd ~/devel /path/to/python36 -m venv eric6env # 激活虚拟环境 # Windows 下执行 eric6env\Scripts\activate.bat # Linux/macOS 下执行 source eric6env/bin/activate python -m pip install --upgrade pip20.3.4这里锁 pip 版本的逻辑是pip 20.3.x 还能用老的 resolver 逻辑识别旧版 PyQt5 的元数据pip 21 之后会对旧包做更严格的依赖协商容易把 QScintilla 解析出问题。如果你不需要旧项目兼容至此环境已经干净可用。3.2 依赖安装与版本锁定命令接着把上一章提到的三件套装进虚拟环境。这里我额外加一个强制参数避免 pip 为了满足依赖自动升级已经安装的 PyQt5pip install PyQt55.10.1 --no-deps pip install QScintilla2.10.8 --no-deps pip install pyqt5-tools5.9.0.1.2--no-deps的意思是不要自动解析传递依赖因为 PyQt5 5.10.1 元数据里没有约束 siplib 版本pip 一旦自作主张装最新的 sip会让 eric6 的 Qt 绑定直接崩溃。装完后可以用以下命令验证导入是否正常python -c from PyQt5.QtCore import QT_VERSION_STR; print(QT_VERSION_STR) python -c import QScintilla; print(QScintilla.QSCINTILLA_VERSION_STR)两条命令都输出一行版本号就说明绑定正常。如果第一条报 DLL 错误或第二条报找不到模块99% 是 PyQt5 或 QScintilla 版本没对齐重新检查锁定版本即可。3.3 启动 eric6 17.12 与首次界面语言切换依赖齐了之后进入 eric6 的源码目录直接运行启动脚本python eric6.py第一次启动会在用户配置目录生成eric6.ini和项目配置文件。这里注意如果你的系统区域是中国且 Python 的 locale 检测正常启动后界面一般直接就是中文。如果还是英文就进Preferences - General - Language把语言下拉框切到zh_CN点 OK 后软件会提示重启生效。这一步网上很多人忽略了一个关键语言切换后菜单的中文翻译资源才加载。但即使界面变成了中文源码编辑器的补全提示和 Qt 设计器里生成的代码注释仍然是按英语环境生成的这是正常的不用反复重启排查。3.4 建第一个项目中文文件名与 UTF-8 源文件的配置语言切换完成后建议立刻建一个带中文路径的测试项目来验证整个环境。操作路径Project - New Project选择项目目录比如E:\work\我的测试项目项目名也直接用中文。eric6 17.12 对中文路径没有硬性拒绝但会在启动调试器时暴露编码问题所以这一步越早验证越好。项目建好后立即进入Project - Project Properties - Editor把 Source Encoding 设成UTF-8。然后在项目里新建一个 Python 文件敲几行中文注释和一个QMainWindow骨架# -*- coding: utf-8 -*- 中文界面测试入口 import sys from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton class MainWindow(QMainWindow): def __init__(self): super(MainWindow, self).__init__() self.setWindowTitle(中文标题测试) self.resize(400, 200) self.btn QPushButton(按钮文案, self) self.btn.move(100, 80) if __name__ __main__: app QApplication(sys.argv) win MainWindow() win.show() sys.exit(app.exec_())这段代码的意图很简单验证编辑器对中文注释的渲染、窗口标题的中文显示、以及按钮上的中文字符是否能正常走完 Qt 的渲染管线。如果这一步在“运行”按钮下能够弹出一个标题正确的中文窗口说明字体与编码配置双双过关。之前我见过很多环境代码能跑但窗口标题是乱码那就是字体问题不是编码问题。4. 中文用户最容易踩的五个坑现象、原因、解决方案4.1 启动报 No module named PyQt5.QtSvg现象双击启动图标后控制台抛ModuleNotFoundError: No module named PyQt5.QtSvg程序退出。原因PyQt5 从 5.14 开始把 QtSvg 模块从主包拆到了单独库或者是因为 pip 安装时用了--no-deps之后再装的 PyQt5 版本偏新。17.12 源码里的QtSvg导入语句是硬编码的找不到就直接崩。解决把 PyQt5 强制降回 5.10.1 并加装对应独立模块。如果在 5.10.1 下重新装仍然报错检查是不是全局 Python 环境里混入了多个 PyQt5在隔离虚拟环境中重装一次就能解决。这一步做完后20 秒内能再次正常启动。4.2 编辑器中文全部变成方框菜单却是正常中文现象界面菜单的中文正常但代码编辑器里输入或打开的中文全变成一个个方框。原因QScintilla 组件的默认字体没有配置 fallback 字体。Qt 在绘制菜单时会走系统字体回退但 QScintilla 的底层 Scintilla 渲染不参与 Qt 的字体回退机制导致中文字符无法映射。解决进入Preferences - Editor - Fonts将默认字体从Consolas之类的英文等宽字体改成同时包含中文字形的字体。我一般用的是SimHei或者Noto Sans Mono CJK SC。改完点应用编辑器里所有中文立即恢复正常。这个坑几乎人人必踩没有例外。4.3 打开旧项目乱码注释灭了一半现象打开一个老项目.py文件里所有中文注释变成鍙橀噺之类的乱码且改动文件后保存乱码固化到磁盘。原因旧项目是用 GBK/GB2312 编码保存的而 17.12 的项目属性里默认编码是 UTF-8。它不是打开时才去探测编码而是直接按 UTF-8 解码遇到无法解码的字节就显示成乱码。解决打开文件前先进入项目属性把Editor - Source Encoding改成GBK或System Default再重新打开文件。注意文件如果已经以 UTF-8 模式被修改并保存过乱码就不可逆了所以遇到老项目第一步永远是先备份目录再去调整编码。我习惯在项目根目录放一个.editorconfig类似角色的配置文件把默认编码写清楚避免多人协作时有人又改回去。4.4 调试器在中文路径下无法启动现象项目路径含中文比如C:\Users\某用户\code\project按 F2 启动调试器时控制台输出启动失败或process finished with exit code 1但直接运行时程序正常。原因eric6 17.12 的调试器默认会写一个临时文件到项目目录下的.eric6tmp隐藏目录这个目录路径拼接到子进程启动参数时编码处理并不完整。Windows 下中文用户名极易触发这个问题。解决给项目设置一个不含中文的缓存目录。路径在Preferences - Debugger - Cache Directory或项目属性里的Debugger - Temporary Directory设置。我一般统一设成C:\Users\Public\eric6_cache\项目名这个目录对中文用户名免疫调试器再没翻过车。这是 17.12 一个非常典型的中国特色 bug新版早就修掉了但老版只能绕行。4.5 装完 17.12双击 .py 文件却黑了 IDLE 先跑现象安装完成后双击.py文件系统仍然用 Python 自带的 IDLE 打开或弹出文件选择器让你重新选程序。原因17.12 的安装器在用户级别注册文件关联时可能因为权限不足或 IDLE 的注册表项优先级更高导致关联写入失败。解决打开 eric6进入Preferences - Tools - File Handlers手动添加.py与.pyw的关联程序为 eric6 的可执行文件路径。如果以后想换回 IDLE直接在系统设置里改默认应用即可不影响 eric6 本体配置。顺带一提有些系统上 eric6 安装版自带的关联脚本需要管理员权限才能写入HKEY_CLASSES_ROOT右键管理员运行安装器可以省掉后续手动关联的麻烦。5. 让 17.12 真正顺手三处隐配置与一个可复现的验证技巧5.1 调整编辑器的自动补全与 API 数据库17.12 的自动补全依赖 QScintilla 的 API 文件。默认安装后API 文件并没有自动加载补全提示空有一副架子。# 检查 eric6 目录下是否存在 api 文件 ls eric/api/python/*.api若文件存在进Preferences - Editor - APIs勾选 Python 3 并 Compile API。编译完成后编辑器里输入QMainWindow.会自动弹出成员提示。没有这一步补全永远只对你最近见过的符号生效。5.2 配置 Qt Designer 和 PyInstaller 外部工具17.12 与 Qt Designer 的对接路径需要手动指定。进Preferences - Tools - External Tools将 Qt Designer 路径指向pyqt5-tools安装目录下的designer.exe。这样你在项目视图里双击.ui文件会直接唤起可视化界面编辑器改完保存后回到 eric6 自动刷新。5.3 一个可复现的中文界面验证脚本最后给一个我每次装完必跑的验证脚本专门用来确认“中文崩溃点”全部排除import sys from PyQt5.QtCore import QLocale from PyQt5.QtWidgets import QApplication, QLabel app QApplication(sys.argv) locale QLocale.system() label QLabel() label.setText(中文环境验证 %s % locale.name()) label.show() sys.exit(app.exec_())跑这个脚本时窗口标题正常显示、label 中文不方框、locale 输出为zh_CN就算全部过关。从那以后我每次在新机器上装完 17.12 或复现类似老环境都会强制走一遍“先锁 pip、再装三件套、改字体编码、最后跑验证脚本”的完整流程省掉后面数不清的排查时间。这份资源如果你手上还没有合适的安装包按上面的版本组合去找能少走很多弯路。希望帮到你。本文还有配套的精品资源点击获取