PyInstaller打包报错：无法从collections导入Sequence求助

问题根源 #

在Python 3.10及以上版本中，Sequence等抽象基类已从collections模块迁移至collections.abc模块。Python 3.11彻底移除了collections中对这些类的直接导入支持，因此任何代码（包括你的项目代码或依赖库）中使用from collections import Sequence都会触发ImportError，后续的SyntaxError通常是该导入错误导致代码执行中断引发的连锁问题。

解决方法 #

1. 修复自身代码中的导入语句 #

如果是你的项目代码中存在该错误导入，直接修改为：

from collections.abc import Sequence

2. 定位并更新依赖库 #

若错误来自第三方依赖库，按以下步骤处理：

• 在Windows PowerShell中执行以下命令，搜索所有依赖库中存在问题的导入语句：

  Get-ChildItem -Path "C:\Python311\Lib\site-packages" -Recurse -Filter "*.py" | Select-String "from collections import Sequence"
  

• 根据搜索结果找到对应的库，查看是否有支持Python 3.11的更新版本，执行pip install --upgrade [库名]进行升级。

3. 临时补丁方案（无法更新依赖时） #

如果依赖库暂无适配Python 3.11的版本，可在主脚本开头添加以下代码进行猴子补丁，临时兼容旧导入方式：

import collections.abc
# 将collections.abc中的类映射到collections模块，兼容旧导入
collections.Sequence = collections.abc.Sequence
collections.MutableSequence = collections.abc.MutableSequence
# 若还有其他类似报错的类，可一并添加

注意：此方案仅为临时 workaround，优先推荐更新依赖库。

4. 检查PyInstaller自定义钩子 #

如果你使用了自定义的PyInstaller钩子脚本，确认其中是否存在from collections import Sequence的语句，如有则修改为from collections.abc import Sequence。

内容的提问来源于stack exchange，提问作者dave