QtFusion安装失败找不到IMcore的解决方案：requirements修复、wheel安装与VibeFlux迁移

问题现象

安装 QtFusion 或安装旧项目依赖时，常见报错如下：

关键报错通常是这两行：

ERROR: Could not find a version that satisfies the requirement IMcore==0.2.7 (from versions: none) ERROR: No matching distribution found for IMcore==0.2.7

如果是直接执行pip install QtFusion，也可能遇到类似问题。原因不是 PyCharm，也不是某个镜像源本身坏了。QtFusion本身仍然可以从 PyPI 获取，真正的问题在于它依赖IMcore；安装 QtFusion 时，pip 会继续解析并安装 IMcore，但截至 2026-06-02，官方 PyPI simple 索引中的IMcore页面返回 404，IMcore 0.3.1也无法通过普通包名方式正常检索，所以整个安装流程会失败。

下面按使用场景给出三种处理方式：改requirements.txt、单独 pip 安装 wheel、直接迁移到升级包 VibeFlux。

根因

这个问题的依赖链很简单：

QtFusion 可用 -> QtFusion 依赖 IMcore -> IMcore 当前不可用 -> pip 安装失败

也就是说，失败点不是 QtFusion 本体，而是 QtFusion 的依赖包IMcore。如果是旧项目，requirements.txt里还经常会有这一行：

IMcore==0.2.7

截至 2026-06-02，再从 PyPI 索引解析IMcore时，会出现找不到包的情况。也就是说，问题不只是0.2.7旧版本不可用，而是IMcore这个依赖当前已经不能按普通包名方式稳定安装。下面是 PyPI simple 索引中的实际返回状态：

因此，只要安装流程需要从索引里找IMcore，就可能卡在No matching distribution found for IMcore。QtFusion 是可用的，但它依赖的 IMcore 解析失败，最终表现出来就是 QtFusion 或项目依赖安装失败。

方案一：修改 requirements.txt

如果你是在项目根目录执行：

pipinstall-rrequirements.txt

就打开项目里的requirements.txt，找到这一行：

IMcore==0.2.7

把这一整行替换成下面这一行：

IMcore @ https://files.pythonhosted.org/packages/90/2e/3a8786ad2e1ae77e7f58fe8e1acb99944ead6c367eb085606633197035d6/IMcore-0.3.1-py3-none-any.whl

注意：IMcore、@、网址之间的空格也要保留，建议整行复制替换，不要只复制网址。

改完后重新安装：

python-mpipinstall-rrequirements.txt

这条写法的意思是：不再让 pip 去 PyPI 索引里搜索IMcore==0.2.7或IMcore>=0.3.1，而是直接从指定的 wheel 文件安装IMcore 0.3.1。

方案二：单独 pip 安装 IMcore wheel

如果你不是通过requirements.txt安装，而是直接安装包，可以先单独安装 IMcore：

python-mpipinstall"IMcore @ https://files.pythonhosted.org/packages/90/2e/3a8786ad2e1ae77e7f58fe8e1acb99944ead6c367eb085606633197035d6/IMcore-0.3.1-py3-none-any.whl"

然后再安装 QtFusion：

python-mpipinstallQtFusion

如果网络无法访问files.pythonhosted.org，也可以使用配套 CSDN 资源包中的本地 wheel 文件来安装这个依赖。资源包解压后会看到一个文件：

imcore-0.3.1-py3-none-any.whl

这个.whl本身就是 Python 安装包，不需要再解压。进入该文件所在目录后直接执行：

python-mpipinstall.\imcore-0.3.1-py3-none-any.whl python-mpipinstallQtFusion

如果你是在 Linux 或 macOS 上运行，把路径写成：

python-mpipinstall./imcore-0.3.1-py3-none-any.whl python-mpipinstallQtFusion

方案三：迁移到 VibeFlux

如果你不想继续处理 QtFusion 和 IMcore 的历史依赖问题，更推荐直接切换到作者发布的全新升级可替换版本：VibeFlux。

PyPI simple 索引中可以看到 VibeFlux 已经提供可安装文件：

安装命令：

python-mpipinstallVibeFlux

迁移方式很简单：把原来代码里的 QtFusion 导入改成 VibeFlux。

原写法：

importQtFusion

改成：

importVibeFlux

如果你的项目里是这种形式：

fromQtFusion.xxximportSomeClass

就把包名前缀换掉：

fromVibeFlux.xxximportSomeClass

其它类、函数和调用方式保持一致即可。对新项目或需要长期维护的项目来说，切换 VibeFlux 比继续修补旧依赖更省心。

怎么选

如果只是想让旧项目立刻跑起来，优先使用方案一：改requirements.txt。如果没有requirements.txt，就用方案二先安装本地或远程的 IMcore wheel。

如果项目后续还要继续维护、部署或分发，建议直接使用方案三迁移到 VibeFlux。这样可以绕开已经失效的 IMcore PyPI 索引问题，也更符合后续升级方向。

参考链接

• PyPI simple：https://pypi.org/simple/imcore/
• PyPI simple：https://pypi.org/simple/qtfusion/
• PyPI simple：https://pypi.org/simple/vibeflux/
• IMcore 0.3.1 wheel：https://files.pythonhosted.org/packages/90/2e/3a8786ad2e1ae77e7f58fe8e1acb99944ead6c367eb085606633197035d6/IMcore-0.3.1-py3-none-any.whl