简介：一份面向中文用户的 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 PyQt5==5.10.1 pip install QScintilla==2.10.8 pip install pyqt5-tools==5.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 pip==20.3.4这里锁 pip 版本的逻辑是：pip 20.3.x 还能用老的 resolver 逻辑识别旧版 PyQt5 的元数据，pip 21 之后会对旧包做更严格的依赖协商，容易把 QScintilla 解析出问题。如果你不需要旧项目兼容，至此环境已经干净可用。
3.2 依赖安装与版本锁定命令
接着把上一章提到的三件套装进虚拟环境。这里我额外加一个强制参数，避免 pip 为了满足依赖自动升级已经安装的 PyQt5：
pip install PyQt5==5.10.1 --no-deps pip install QScintilla==2.10.8 --no-deps pip install pyqt5-tools==5.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、再装三件套、改字体编码、最后跑验证脚本”的完整流程，省掉后面数不清的排查时间。这份资源如果你手上还没有合适的安装包，按上面的版本组合去找，能少走很多弯路。希望帮到你。
本文还有配套的精品资源，点击获取
