You need to enable JavaScript to run this app. Python已用pip3安装chess模块,运行代码报无chess.svg错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Python已用pip3安装chess模块,运行代码报无chess.svg错误如何解决

问题根源

你遇到的是Python开发里非常常见的本地脚本名与第三方库重名导致的导入冲突,核心原因就是你把自己写的运行脚本直接命名成了chess.py。

Python解析import语句时的路径查找有固定优先级:

  • 最先查找当前运行脚本所在的工作目录
  • 之后才会依次遍历PYTHONPATH配置的路径、site-packages下的第三方库安装路径

对应你的报错链路:

  1. 你在存放chess.py的目录下运行脚本时,第一行代码执行import chess
  2. Python在当前目录直接匹配到了你自己写的chess.py文件,根本不会去加载你之前通过pip安装到/home/XusernameX/.local/lib/python3.8/site-packages路径下的官方chess库
  3. 当脚本运行到第二行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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 08:24:01