Python已用pip3安装chess模块,运行代码报无chess.svg错误如何解决
问题根源
你遇到的是Python开发里非常常见的本地脚本名与第三方库重名导致的导入冲突,核心原因就是你把自己写的运行脚本直接命名成了chess.py。
Python解析import语句时的路径查找有固定优先级:
- 最先查找当前运行脚本所在的工作目录
- 之后才会依次遍历PYTHONPATH配置的路径、site-packages下的第三方库安装路径
对应你的报错链路:
- 你在存放
chess.py的目录下运行脚本时,第一行代码执行import chess - Python在当前目录直接匹配到了你自己写的
chess.py文件,根本不会去加载你之前通过pip安装到/home/XusernameX/.local/lib/python3.8/site-packages路径下的官方chess库 - 当脚本运行到第二行
import chess.svg时,Python会尝试在你自己写的这个chess.py对应的模块里找svg子模块,但你自己写的文件只是一个普通脚本,根本不是包含子模块的Python包,因此抛出No module named 'chess.svg'; 'chess' is not a package的报错。
你之前排查PYTHONPATH配置是没问题的,只是因为当前工作目录的查找优先级远高于PYTHONPATH里配置的路径,所以你配置的第三方库路径根本没被查询到。
解决步骤
- 把当前目录下的
chess.py重命名为其他不与Python标准库、已安装第三方库重名的名称,比如chess_demo.py - 删除当前目录下自动生成的
__pycache__缓存文件夹,避免旧的字节码缓存干扰模块导入 - 重新运行重命名后的脚本,即可正常加载已安装的chess第三方库
日常避坑提示:编写Python脚本时,尽量不要使用与标准库、已安装第三方库完全同名的文件命名,从根源上避免这类导入冲突问题。
内容的提问来源于stack exchange,提问作者Trick Jarrett
相关产品推荐
相关产品推荐

