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.8eric6 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 PyQt55.10.1 QScintilla2.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 PyQt55.10.1 QScintilla2.10.4 pyflakes autopep8 # 3. 执行安装脚本 python install.pyinstall.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.iniLinux 上是~/.config/eric6/eric6.ini。这个配置文件是 ini 格式后面调中文、改编码都是直接改这里或者通过 IDE 的设置界面改两种方式等价。4. 配置中文界面与编辑行为三个必调项4.1 切换中文语言包界面语言为何默认不生效装完 17.12 之后打开界面默认可能是英文。这个年代的老版本安装包有个特点中文语言包文件在安装目录里躺着但默认不启用需要手动设置。语言设置在Preferences菜单下的General选项里把Language从System切到zh_CN重启才生效。# 不想点菜单也可以直接改配置文件 # 在 eric6.ini 中找到 [General] 段 # 写入 # [General] # Languagezh_CNLanguagezh_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] 段里 # DefaultEncodingUTF-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 QScintilla2.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里Languagezh_CN没有被注释最后看配置文件是不是被某次异常退出回滚了。有一次我遇到的情况是解压安装包时用了中文路径比如D:\软件\eric6-17.12Qt 的翻译文件加载在 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_MODULEfcitx然后从同一个终端启动 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 最小窗口、触发一次自动补全、设置一次断点。十分钟的时间能把八成问题提前暴露出来避免真到写项目时才发现自己装的环境根本跑不通。希望能帮到正在折腾的你。本文还有配套的精品资源点击获取

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

相关推荐

MATLAB实现InSAR时序分析：从SLC到形变序列的全流程避坑指南

Lombok原理：如何在javac编译期修改AST生成代码

OpenCV 2.4.13 zip资源详解：从源码编译到项目集成避坑指南

更多资讯

基于LCL滤波的三相并网逆变器控制仿真设计（带参考资料）

描述驱动Web UI自动化：基于YAML的回归测试框架设计与实践

Abaqus内置黏弹性本构模型验证

LangGraph生产级智能体实战：核心组件与编排经验

Surface Duo 刷机全攻略：ADB Sideload 避坑指南

从一段真实的 Electron IM 前端代码，看高级前端的工程化修养

今日更新

智能硬件视频会议集成：从芯片选型到场景落地的全栈实践

FFmpeg音视频处理与5路RTMP推流实战：从原理到118克盒子部署

RK3528+1GB内存如何变身直播节点？硬编解码与六协议实战复盘

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？