企业官网建设流程全解析

简介：eric6 17.12 是官方支持中文界面的最后一个版本，这份安装包面向习惯中文环境、使用 Python 3 进行桌面开发的程序员，尤其适合在 Windows 10 上搭建 PyQt5 图形界面项目的初学者与中级开发者。压缩包共 6399 个文件，约 27.03MB，以 py 源码、pyc 字节码、html 帮助文档、png 图标、ui 界面文件为主，另含 xml、qrc、qm 翻译、api 补全等资源，完整保留了 IDE 的界面、插件与文档体系。已有 1093 人学习下载。解压后可直接部署，配合 PyQt5 与 PyQt5-tools 即可运行，内置源代码编辑、断点调试、多项目管理、Git 版本控制与插件扩展等能力，中文界面能显著降低语言门槛，方便对照官方文档与社区资料排查环境依赖问题，是留存旧版中文体验的实用选择。

1. 为什么我还在用 eric6 17.12：一个被中文编码逼回来的版本选择

如果你最近在 Windows 上折腾 Python 的 IDE，大概率会先装 PyCharm 或者 VS Code，很少有人会主动去找 eric6。但有些场景就是绕不开它——比如你维护着一套老项目，代码里混着 GBK 和 UTF-8，菜单栏里必须显示中文，而新版 eric 已经把中文支持砍得七七八八。我就是在一次迁移里被逼回来的：新版本装完，界面全是英文不说，打开旧工程直接乱码，控制台报一堆 UnicodeDecodeError。折腾了一下午，最后翻出 eric6 17.12 这个安装包，才把环境重新跑通。这篇笔记就记录我从零装这套环境的完整过程，包括 Python 版本怎么选、PyQt 怎么配、中文怎么设，以及装崩了怎么救回来。如果你也在找 eric6 中文版的落地方法，照着走一遍应该能省下不少时间。

2. 装之前先把环境列清楚：Python 和 PyQt 的版本对应关系

2.1 为什么 eric6 17.12 对 Python 版本这么挑

eric6 本身是一个用 Python 写的 Qt 应用，它依赖 PyQt5 来渲染界面。17.12 这个版本发布的时候，PyQt5 的主流版本是 5.9 到 5.10 之间，Python 这边则横跨 3.5 到 3.6。如果你直接拿 Python 3.11 去装，pip 会告诉你找不到匹配的 PyQt5 wheel，因为新版本 PyQt5 的 ABI 和 eric6 内部调用的接口已经对不上了。我一般会建议把 Python 锁在 3.6.8 这个版本，它是 3.6 系列最后一个带 Windows 安装包的版本，和 eric6 17.12 的兼容性最稳。如果你机器上已经有 3.8 以上，别急着卸载，用虚拟环境隔开就行。

2.2 我用的版本组合清单

下面这张表是我实测能跑通的组合，不是唯一解，但照着装基本不会翻车：

提示：如果你用的是 Anaconda，可以直接conda create -n eric6env python=3.6.8，省去单独装 Python 的步骤。但 PyQt5 建议用 pip 装，conda 源里的版本有时候会偏。

2.3 安装 Python 3.6.8 时要注意的两个勾选项

去 Python 官网下载 3.6.8 的 Windows 安装包，运行之后第一个界面底部有两个复选框：一个是“Add Python 3.6 to PATH”，另一个是“Install for all users”。我建议两个都勾上。第一个不用多说，不勾的话后面命令行里调 python 会找不到；第二个勾上之后，安装路径会变成C:\Program Files\Python36，权限清晰，不会因为用户目录带中文导致后续 pip 装包时路径解析出错。安装类型选“Customize installation”，确保 pip 和 tcl/tk 都被选中，tcl/tk 虽然 eric6 用不到，但后面如果要用 IDLE 调试会方便些。

装完之后开个新的 cmd 窗口，敲python --version，确认输出是Python 3.6.8。如果提示不是内部命令，说明 PATH 没生效，手动把C:\Program Files\Python36和C:\Program Files\Python36\Scripts加到系统环境变量里。

3. 一步步装依赖：从 PyQt5 到 eric6 的完整命令流

3.1 先升级 pip 并锁定安装源

Python 3.6.8 自带的 pip 版本是 18.1，这个版本在装 PyQt5 的时候偶尔会卡在“Collecting”阶段。我一般先升到 21.3.1，这是最后一个支持 Python 3.6 的 pip 版本：

python -m pip install --upgrade pip==21.3.1

升完之后确认一下版本：

pip --version

输出里应该带python 3.6字样。如果显示的是其他 Python 版本，说明你机器上有多套 Python，需要用python -m pip来指定当前解释器。这一步看着简单，但我见过不少人在这里翻车——pip 装到了别的 Python 下面，后面 eric6 启动时找不到 PyQt5。

3.2 安装 PyQt5 和 QScintilla

PyQt5 的安装命令本身不复杂，但版本号必须写死：

pip install PyQt5==5.10.1

装完之后再装 QScintilla：

pip install QScintilla==2.10.4

这两个包加起来大概 50MB 左右，下载速度取决于你的网络。如果中途报错说“Microsoft Visual C++ 14.0 is required”，说明你的系统缺 VC++ 运行库，去微软官网下载 Visual C++ Build Tools 装上就行。注意不要装最新版，2015 版的运行库就够用。

装完验证一下：

python -c "from PyQt5.QtCore import QT_VERSION_STR; print(QT_VERSION_STR)"

如果输出5.10.1，说明 PyQt5 已经就位。如果报 ImportError，大概率是 PyQt5 装到了别的 Python 环境里，用pip show PyQt5看一下 Location 字段指向哪个目录。

3.3 安装 eric6 17.12 本体

eric6 的安装包是一个.tar.gz或者.zip，解压之后进入目录，执行：

python install.py

这个脚本会做几件事：检查 PyQt5 和 QScintilla 是否满足最低版本要求、编译翻译文件、把 eric6 的启动脚本复制到 Python 的 Scripts 目录。如果一切正常，最后会提示“Installation completed successfully”。如果中途报错，最常见的是 QScintilla 版本不够，脚本会明确告诉你需要 2.10 以上。

装完之后，在命令行里敲：

eric6

如果弹出一个英文界面的窗口，说明主程序已经能跑了。但我们要的是中文版，所以还得继续配。

4. 配中文和编码：让 eric6 17.12 真正变成中文版

4.1 界面语言切换的两种方式

eric6 17.12 自带多语言支持，中文翻译文件在安装目录的eric6/i18n下面，文件名是eric6_zh_CN.qm。切换方式有两种：

第一种是在 eric6 界面里点Settings→Preferences→Interface→Language，下拉选“Chinese (China)”，重启之后生效。但如果你装完就是英文界面，这个下拉框里可能只有 English 一个选项，原因是翻译文件没有被正确加载。

第二种是手动指定语言启动：

eric6 --language=zh_CN

这个命令会强制加载中文翻译。如果启动后界面还是英文，说明eric6_zh_CN.qm文件缺失或者路径不对。去安装目录下确认一下这个文件是否存在，如果没有，从安装包的i18n目录里手动复制过去。

4.2 编码设置：解决打开旧文件乱码的问题

中文界面只是第一步，真正影响日常使用的是编码。eric6 默认用 UTF-8 打开文件，但很多老项目是 GBK 编码，直接打开就是乱码。我一般会在Preferences→Editor→File Encoding里做三件事：

第一，把“Default Encoding”改成System，这样 eric6 会跟随操作系统的区域设置，中文 Windows 下就是 GBK。第二，勾选“Auto-detect Encoding”，让编辑器在打开文件时自动探测编码。第三，在“Encoding for New Files”里保持 UTF-8，新文件还是用 UTF-8 存，避免以后迁移麻烦。

配置完之后，打开一个 GBK 编码的旧文件试试，如果中文正常显示，说明编码设置生效了。如果还是乱码，检查一下文件本身有没有 BOM 头，有些编辑器会在 UTF-8 文件开头加 BOM，eric6 对 BOM 的处理有时候会误判。

4.3 把配置固化下来：导出和导入设置

配好之后别急着关，点Settings→Export Preferences，把当前配置导出一个.ini文件。下次换机器或者重装环境，直接Import Preferences就能恢复，不用再一条条改。我一般会把这份配置和 eric6 安装包放在同一个目录里，标注好 Python 版本和 PyQt5 版本，过半年再回来看也不会忘。

5. 避坑记录：装 eric6 17.12 时最容易翻车的五个地方

5.1 现象：pip 装 PyQt5 时报“No matching distribution found”

原因：pip 默认去 PyPI 拉最新版，但最新版 PyQt5 已经不支持 Python 3.6 了，所以找不到匹配的 wheel。解决：命令里必须写死版本号PyQt5==5.10.1，不能只写pip install PyQt5。如果写死版本号还是报错，检查一下 pip 是不是太旧，用pip install --upgrade pip==21.3.1升一下。

5.2 现象：eric6 启动时报“ModuleNotFoundError: No module named 'PyQt5.QtWebEngineWidgets'”

原因：eric6 17.12 的部分功能依赖 QtWebEngine，但 PyQt5 5.10.1 的 wheel 包里默认不包含这个模块。解决：单独装PyQtWebEngine，命令是pip install PyQtWebEngine==5.10.1。如果这个版本也找不到，可以装 5.10.0，接口差异不大。

5.3 现象：中文菜单显示为方块或问号

原因：系统缺少中文字体，或者 eric6 的翻译文件没有正确加载。解决：先确认eric6_zh_CN.qm文件存在，然后用--language=zh_CN参数启动。如果还是方块，检查 Windows 的“区域和语言”设置里有没有装中文语言包，没有的话补上。

5.4 现象：安装脚本执行到一半报“QScintilla version too old”

原因：pip 自动装了最新版 QScintilla，但 eric6 17.12 的安装脚本只认 2.10.x 的版本号。解决：先卸载pip uninstall QScintilla，再装指定版本pip install QScintilla==2.10.4。如果卸载不干净，手动去site-packages目录删掉PyQt5下面相关的Qsci文件夹。

5.5 现象：装完之后命令行里敲 eric6 没反应

原因：Python 的 Scripts 目录没有加到 PATH 里，或者 eric6 的启动脚本没有被正确复制。解决：先确认C:\Program Files\Python36\Scripts在 PATH 里，然后去这个目录下看有没有eric6.bat或eric6.exe。如果没有，重新跑一遍python install.py，注意看最后几行输出有没有报错。

6. 装完怎么验证：三个检查点和一个后悔药习惯

装完 eric6 17.12 之后，别急着写代码，先花五分钟做三个验证。第一个验证是界面语言：启动 eric6，看菜单栏是不是中文。如果还是英文，用eric6 --language=zh_CN启动一次，确认翻译文件能被加载。第二个验证是编码：新建一个文件，输入几个中文字符，保存为 GBK 编码，关掉再打开，看是否正常显示。第三个验证是 PyQt5 集成：在 eric6 里新建一个 Qt 项目，随便拖一个按钮，运行一下看能不能弹出窗口。这三个都过了，说明环境基本没问题。

我还会做一个额外的检查——把 eric6 的版本号和依赖版本记在一个文本文件里，放在安装目录旁边。内容大概是这样：

eric6: 17.12 Python: 3.6.8 PyQt5: 5.10.1 QScintilla: 2.10.4 Install date: 2025-01-15

这个习惯是从一次惨痛经历来的：当时装好环境跑了三个月，突然有一天 PyQt5 被别的项目升级到了 5.15，eric6 直接打不开。排查了半天才想起来是版本冲突。从那以后我每次装完 eric6 都会把版本清单写下来，并且在虚拟环境里装，不跟其他项目混用。如果你不想用虚拟环境，至少把这份清单留着，下次出问题的时候能快速定位。

最后说一个我常用的“后悔药”操作：装完 eric6 之后，把整个 Python 3.6.8 的安装目录打包成一个 zip，放在移动硬盘里。哪天环境崩了，直接解压覆盖，比重新装一遍快得多。这个做法有点笨，但确实省时间。希望帮到你。

本文还有配套的精品资源，点击获取