简介Eric6 17.12 是面向中文 Python 开发者的集成开发环境也是最后一个原生支持中文界面的版本针对旧版界面语言障碍与后续版本不兼容等问题提供了直接解决方案适合 Windows 10 下偏好中文操作界面的入门到进阶开发者无论是编写脚本、桌面程序还是 Web 后端都能获得顺畅的中文操作体验。压缩包共含 6399 个文件以 py/pyc 源码、html 帮助文档、png 图标、ui 界面描述文件为主py/pyc 对应程序主体与缓存html/png 提供文档和图标ui 描述 Qt 界面布局并附有 qrc、ts/qm 翻译资源、项目模板与插件样例整体 27.03MB足以支撑完整的 IDE 运行和界面本地化。目前已有 1094 人浏览学习可见中文本地化 Python 工具在开发者中确有持续需求。资源以安装包形式交付内置调试器、项目管理、语法高亮、Git 集成和插件系统等完整功能同时覆盖多语言翻译文件、API 文档与示例资源便于使用者在中文环境下快速开展 Python 项目开发减少配置环境和语言切换的成本。1. 先聊一个版本怪圈为什么大家都在找 eric6 17.12 中文版如果你在搜索 eric6 中文版翻几页就会发现一个奇怪的现象老手推荐的不是新版而是 2017 年底放出的 17.12。理由很朴素——从 18.x 开始官方改了界面翻译文件的发布方式中文翻译经常延迟不少菜单项直接退回英文还有人反馈在中文 Windows 下打开 UTF-8 源码时注释里的汉字会变成乱码。于是还在长期维护旧项目的人干脆停在 17.12把它当成“内置中文支持最完整”的版本。这篇笔记会把 17.12 在 Python 3.7 环境下从依赖、安装到中文配置完整走一遍给出我装了三台机器后固定下来的命令和参数。中间也会把最容易翻车的几个坑提前摆到台面省得你在网上一条条搜报错。2. 装前准备Python 版本和 PyQt5 依赖先定下来再动手安装 eric6 17.12 和装普通软件不一样它本身是一套 Python 脚本界面依赖 PyQt5编辑器组件依赖 QScintilla。任何一层版本选错后面都会以“启动闪退、插件列表为空、调试器连不上”的形式代价。所以第一步不是找安装包而是把你机器上的 Python 和 GUI 依赖先理清楚。2.1 Python 版本3.7.9 是 17.12 最舒服的底座eric6 17.12 发布那段时间开发环境主要跑在 Python 3.6 和 3.7 上。它内部对插件 API 的检测、对调试器协议的处理基本是按 3.6/3.7 的行为验证过的。我一开始图省事在 Python 3.9 上直接跑界面能起但第一次启动调试器就弹“无法启动调试客户端”。换回 3.7.9 后一切恢复正常。所以如果你打算把它当主力 IDE 用建议不要跨大版本冒险。Windows 下我推荐直接装官方 3.7.9 安装包安装时务必勾选 Add Python to PATH然后用下面两条命令确认python --version py -3.7 --version第一行用的是当前默认解释器第二行是检查系统里是否已经存在另一个 3.7。装了新版 Python 的机器上py命令可能默认指向 3.12所以一定要在命令行里确认你实际用的是哪一个。如果系统里已经装了好几个 Python后面安装 PyQt5 和 eric6 时必须从头到尾用同一个解释器否则会出现“包装进去了程序却找不到”的怪问题。Linux 或 macOS 用户我一般用 pyenv 管理版本命令会清晰很多pyenv install 3.7.9 pyenv local 3.7.9 python --versionpyenv local只让当前目录使用 3.7.9不解压错地方的话后面安装步骤全在这个目录里执行就不会走偏。macOS 上如果直接用 brew 安装 3.7.9依赖路径容易散到系统目录里排查起来更麻烦所以我还是建议统一走 pyenv。2.2 PyQt5 和 QScintilla装错了轻则花屏重则闪退确认好 Python 后接下来装 GUI 依赖。eric6 17.12 的界面基于 PyQt5代码编辑器里的高亮和自动补全则依赖 QScintilla另外插件管理器和内置网页工具还需要 QtWebEngine。这几样缺一不可。我习惯新建一个虚拟环境来隔离依赖避免污染系统 Pythonpython -m venv eric6env # Windows 激活 eric6env\Scripts\activate # Linux / macOS 激活 source eric6env/bin/activate激活后先升级 pip再一次性装齐pip install --upgrade pip pip install PyQt5 PyQt5-sip QScintilla PyQtWebEngine这里有一个版本上的取舍。如果你用的是 Python 3.7pip 会自动解析到当时对应的一批 PyQt5 版本和 eric6 17.12 兼容性最好如果系统里是 Python 3.8 以上pip 大概率会装到较新的 PyQt5 5.15 系列启动一般也没问题但 QScintilla 版本太新时编辑器窗口会在打开文件的一瞬间闪退。遇到这种表现先把 QScintilla 退回到 2.11.x 系列再试pip uninstall QScintilla pip install QScintilla2.11,2.14注意不要装 PyQt6eric6 17.12 完全无法识别 PyQt6 的模块路径。同样PyQtWebEngine必须单独装新版 PyQt5 已经把 WebEngine 拆出来不装的话后面插件管理器会变成空列表帮助窗口也打不开。2.3 依赖自检两行命令确认 Qt 环境可导入依赖装完后不要急着解压 eric6先做一次导入检查python -c from PyQt5.QtCore import QT_VERSION_STR; print(Qt, QT_VERSION_STR) python -c import PyQt5.QtWebEngineWidgets; print(web ok) python -c import QScintilla; print(qsci ok)第一条能看到实际链接的 Qt 版本号后面两条分别验证 WebEngine 和 QScintilla 是否可导入。如果这里报ModuleNotFoundError现在排查比等启动 eric6 时再排查简单得多。常见结果是 PyQt5 没装到当前虚拟环境里或是 QScintilla 的编译产物和 Python 版本不匹配卸载重装对应包即可。提示后面所有安装命令都在同一个虚拟环境激活状态下执行避免出现依赖装了等于没装的情况。3. 下载并安装 eric6 17.12从压缩包到桌面的完整流程这一章解决“下载下来之后怎么办”。eric6 17.12 的发行包是一个 zip 或 tar.gz 压缩包里面是完整的 Python 源码与安装脚本。你可以选择正式安装进 site-packages也可以不安装、直接从源码目录启动。两种方式各有适用场景我分别说明。3.1 使用官方 zip 包执行 install.py 安装WindowsWindows 下我先把下载好的eric6-17.12.zip解压到一个纯英文路径例如C:\tools\eric6-17.12。这一步不是玄学安装脚本会生成桌面快捷方式如果路径里带中文生成的快捷方式参数在部分 Windows 区域设置下会出现编码错乱启动时反而找不到 Python。进入解压目录后执行安装脚本cd C:\tools\eric6-17.12 python install.py脚本运行后会自动检测当前 Python 版本然后把 eric6 的各模块复制到Lib\site-packages目录下并且在 Python 的Scripts目录里生成启动脚本eric6.exe或eric6.bat。这时不用去管它输出的一大堆日志只要最后一行提示安装完成即可。如果你想指定安装目录可以先看下脚本支持哪些参数python install.py --help常见做法是想装进当前用户目录时通过参数指定--install-dir避免写入系统级目录导致权限报警。需要注意如果当前用户没有虚拟环境所在目录的写权限install.py 可能中途失败Windows 下可以临时以管理员身份打开命令提示符再执行但我个人更推荐把虚拟环境建在用户目录下绕开权限问题。3.2 不安装直接跑源码适合临时试用和 Linux/macOS有时候你只是想快速看一眼这个版本是否可靠或者是在 Linux 服务器上临时用我可以不执行 install.py直接解压后运行源码入口tar xzf eric6-17.12.tar.gz cd eric6-17.12 python eric6.py这种方式适合临时试用因为 eric6 的大部分逻辑都从当前目录加载不需要复制进 site-packages。Windows 的 zip 包里同样有eric6.py命令行切到目录后python eric6.py也能启动。第一次运行会初始化配置文件和缓存目录所以启动会慢一点属于正常现象。不过要注意用源码方式直接跑时语言文件路径是相对源码目录的。如果你解压后顺手把 zip 包删了目录又被移动界面语言可能切不回中文。所以长期使用我还是推荐先走一遍 install.py安装完成后源码目录其实可以删掉系统里已经有一份完整副本了。3.3 安装目录和启动脚本装完后去哪找 eric6安装完成后如果找不到启动入口很容易误以为装失败。其实 eric6 的安装结构很规律Windows 下启动脚本在 Python 的Scripts目录中名字是eric6.exe或eric6.bat。直接双击它即可启动也可以发送快捷方式到桌面。Linux 下install.py 会在 Python 的 bin 目录里生成一个eric6可执行文件终端输入which eric6就能看到路径。另外安装目录中还会附带uninstall.py用于卸载。我建议保留这个脚本别手动删目录否则 site-packages 里残存的模块会导致下次重装时版本混乱。安装完也可以顺手运行一下python uninstall.py --help熟悉卸载选项以后想换版本时能一次清干净。这个习惯在我反复切换 17.12 和 18.x 对比时帮了大忙。4. 中文配置实操界面语言、编辑器编码和调试器输出安装完成只是第一步真正让 17.12 成为“中文版 eric6”的是接下来这三处设置。很多人装了老版本却依然是英文界面或者中文注释乱码问题都出在这里。4.1 界面切中文Preferences 里那一个下拉框启动 eric6 后菜单栏默认是英文。点击Settings→Preferences在弹出的配置对话框中找到Interface→Language。这个下拉框里列出了所有已翻译语言。选择Chinese或zh_CN然后点Apply重启 eric6 后可以看到菜单、对话框和右键菜单基本都变成中文了。这里有一个容易被忽略的细节如果下拉框里没有中文选项说明语言文件没有被正确加载。原因通常是你用了上一章说的“源码直接跑”的方式并且解压目录被移动过。检查一下 eric6 安装目录下i18n文件夹里是否存在eric6_zh_CN.qm文件没有的话重新执行一次 install.py 或者回退到原路径再启动。界面语言和系统语言是两回事。即使 Windows 或 Linux 系统是中文eric6 也需要单独设置它不会自动跟随系统区域切语言。4.2 编辑器编码把 UTF-8 定为默认告别中文注释乱码另一个高频问题是界面已经中文了但打开 Python 文件后里面的中文注释变成鍟婂憖之类的内容或者保存时报编码错误。这通常是 QScintilla 使用的默认编码和文件实际编码不一致导致的。配置路径在Settings→Preferences→Editor→Advanced。把其中涉及Encoding的选项统一设为UTF-8同时建议勾选“打开文件时自动检测编码”不同版本叫法略有差异但一定在同一个配置页。这样新文件默认以 UTF-8 创建打开老文件时也能先按 BOM 或内容推断编码。改完之后顺手验证一遍在编辑器里新建一个文件输入“你好 eric6”作为注释保存为utf8_test.py关闭文件再重新打开。如果注释不再乱码说明编辑器这一环已经通了。那种“保存时变成问号”的情况大多数是因为 Windows 控制台代码页和文件编码不匹配这跟编辑器无关我放在下一节单独处理。注意如果你手里的项目是 GBK 编码的老代码不要强改成 UTF-8否则代码里的中文字符串会全部变成乱码。正确做法是打开文件前在文件选择对话框右下角手动把编码切成 GBK。4.3 调试器中文输出控制台乱码的终极解法代码里print(你好)在 eric6 的调试器输出窗口第一次运行时经常遇到UnicodeEncodeError: gbk codec cant encode character。原因是 Python 在 Windows 下默认 stdout 编码是 GBK而终端窗口期望的是 Unicode。这个错误杀死了很多新手的热情。最直接的解决方式是在启动 eric6 前设置一个环境变量Windows 命令提示符set PYTHONIOENCODINGutf-8 eric6Linux / macOSexport PYTHONIOENCODINGutf-8 eric6设置之后Python 的标准输出会强制使用 UTF-8 编码调试器里打印中文就不会再抛异常。如果是在 Windows 图形界面里双击快捷方式启动可以在快捷方式的目标里保留参数或者在系统环境变量中全局添加PYTHONIOENCODINGutf-8。我选择的是全局添加因为其他日常脚本也可能遇到同类问题。5. 常见问题/避坑安装和启动阶段最容易踩的 5 个坑下面这五个坑我几乎在每次换机器装 17.12 时都会遇到至少一个。按“现象 → 原因 → 解决”的格式整理出来你可以直接对号入座。5.1 启动报缺 PyQt5.QtWebEngineWidgets现象启动 eric6 后立刻弹出ModuleNotFoundError: No module named PyQt5.QtWebEngineWidgets或者帮助窗口打不开。原因新版 PyQt5 把 WebEngine 相关模块拆成了一个独立发行包不再随 PyQt5 一起安装。17.12 的插件管理器、帮助窗口都依赖这个模块缺了它程序宁可退出也不降级运行。解决在虚拟环境里执行pip install PyQtWebEngine然后重启 eric6。如果你已经开始启动脚本出现这个错装完包后直接重新运行不需要重装 eric6。这个坑在 Python 3.8 环境尤其常见属于最容易忽视的依赖。5.2 界面字体全是方块现象中文菜单和代码注释的汉字显示成一个个方块英文正常。原因Qt 在启动时匹配了一套不含中文字形的字体常见于精简版 Windows 或未安装完整字体包的 Linux 桌面。解决在Preferences→Interface→Fonts里把界面字体改为系统已安装的中文字体。Linux 下如果没有中文字体先安装noto-sans-cjk或wqy-microhei安装后重新打开 Preferences 才有对应字体可选。Windows 下一般直接选思源黑体或宋体都能解决。改完字体必须重启 eric6字体渲染的缓存才会刷新。5.3 插件管理器里面空荡荡现象打开插件管理器后插件列表是空的或者只有少部分自带插件。原因eric6 的插件系统在加载前会检查 QtWebEngine 是否可用如果上一节那个模块缺失插件列表会被静默隐藏不会报错。这个表现很迷惑人因为它不直接弹错误窗口。解决先确认PyQtWebEngine已安装再检查虚拟环境的 site-packages 里是否存在PyQt5/QtWebEngineWidgets.py。存在的话删除 eric6 缓存目录通常在~/.config/eric6下的*.pyc再重启。如果依然为空就用python install.py重新安装一次 eric6重置插件路径。5.4 Python 版本检测不通过现象启动时弹窗提示 Python 版本太旧或太新拒绝运行。原因17.12 内部对 Python 版本有硬性检查过老的 2.x 或过新的 3.10 都不在其验证范围。虽然某些高版本能强行跑通但调试器协议、插件 API 都可能有兼容性问题官方设计上就是谨慎处理。解决最稳妥的是回到 Python 3.7.9其次是尝试 3.8.0。如果你是 pyenv 或 conda 用户直接切版本最方便如果没有多版本管理工具不建议去改动 eric6 源码里的版本判断因为改完还可能触发其他 API 兼容问题属于拆东墙补西墙。5.5 打开中文文件名乱码或保存失败现象打开一个名为测试.py的文件时标题栏显示乱码或者编辑后保存提示UnicodeEncodeError。原因Qt 在解释文件名字符串时使用了系统区域语言编码。中文 Windows 默认是 GBK而 eric6 内部用 UTF-8 处理路径和文件名两边一交换就出问题。解决打开文件前先在文件对话框右下角把编码切到 UTF-8。长期使用的话建议把操作系统区域设置里的“使用 Unicode UTF-8 提供全球语言支持”打开Windows 10 以上可用这时文件对话框和编辑器两侧统一到 UTF-8文件名就不再乱码。Linux/macOS 下这类问题少见因为系统区域通常是 UTF-8。6. 装完怎么验证三分钟跑通一个带中文输出的完整项目安装和配置都做完后下一步不是急着写业务代码而是用一套固定流程验证环境真的可用。我每次装完 eric6 17.12都会按下面三步走一遍走不通就说明还有隐藏问题。6.1 版本确认关于对话框和命令行要对得上先启动 eric6点击帮助→关于确认对话框里显示的版本是 17.12并且语言是中文。这一步能同时验证两个结果版本号是否正确、界面语言有没有切到中文。很多从网上找的资源包文件名叫 17.12实际解压出来是 18.1 改的目录名关于对话框里一眼就能看穿。再回到命令行切换到虚拟环境后执行python -c import PyQt5.QtCore; print(PyQt5.QtCore.QT_VERSION_STR)屏幕上打印出的 Qt 版本号应该和 About 对话框里显示的一致。如果不一致说明启动桌面版本时可能调用了另一个 Python 环境这通常是因为 Windows 快捷方式里的路径写死了另一个解释器。删掉快捷方式从当前虚拟环境的Scripts目录重新生成即可。6.2 最小项目验证新建、编码、运行、调试一条线在 eric6 里新建一个项目添加一个 Python 文件hello.py写入# -*- coding: utf-8 -*- print(你好eric6 17.12) print(hello world)这短短的 3 行能测出三层问题第一行的编码声明是给历史遗留场景用的中文print能验证上一章设置的PYTHONIOENCODINGutf-8是否生效打印英文则是排除干扰项。保存并运行这个文件。如果输出窗口里两行都正常显示说明编码链路通了。下一步再验证调试器在第二行代码前打一个断点用调试模式启动。顶部应该出现调试工具栏变量窗口里能看到 Python 的__name__变量值和源码完全对应没有编码报错。6.3 给以后留下的检查习惯这套验证看起来简单但每次换机器、换 Python 版本我都会强制自己重新走一遍——先python --version确认解释器再跑依赖导入的三行命令最后进 eric6 跑一遍 hello.py。一旦哪一步报错我宁可当场停下排查也不要急着把项目代码导进去。曾经有一次我图省事跳过基础验证直接打开旧项目结果调试器连不上折腾了一个下午才发现是 QScintilla 版本太新。从那以后我把它当成一种固定动作装完不跑基础测试等于没装。这套流程也分享给你希望帮到你。本文还有配套的精品资源点击获取
