VS Code中循环导入错误无法消除的问题求助

问题 #

在笔记本电脑的VS Code中，终端持续出现循环导入错误，尝试修改代码、清理缓存、卸载重装VS Code后仍无法解决。已在台式机上修复循环导入问题，将修复后的代码复制到笔记本运行时，错误依旧——哪怕已经删除了曾引发循环导入的文件，且当前代码不存在循环导入逻辑。

无论运行什么代码，终端都会返回如下错误：

Traceback (most recent call last):
  File "c:\Users\kdogg\OneDrive\Desktop\Anime-Ultimate\AnimeUltimateBot\main.py", line 2, in <module>
    from discord.ext import commands
  File "C:\Users\kdogg\AppData\Local\Programs\Python\Python311\Lib\site-packages\discord\ext\commands\__init__.py", line 11, in <module>
    from .bot import *
  File "C:\Users\kdogg\AppData\Local\Programs\Python\Python311\Lib\site-packages\discord\ext\commands\bot.py", line 38, in <module>
    from .core import GroupMixin
  File "C:\Users\kdogg\AppData\Local\Programs\Python\Python311\Lib\site-packages\discord\ext\commands\core.py", line 9, in <module>
    class PlayerProfiles(commands.Bot):
                         ^^^^^^^^^^^^
AttributeError: partially initialized module 'discord.ext.commands' has no attribute 'Bot' (most likely due to a circular import)
PS C:\Users\kdogg\OneDrive\Desktop\Anime-Ultimate>

原因与解决方案 #

原因 #

错误提示看似指向模块内部循环导入，但你的代码已修复，实际问题出在本地Python环境的discord.py包损坏，或项目目录存在与模块同名的文件/文件夹，干扰了官方包的正常导入。

解决方案 #

• 排查项目内冲突文件
  检查项目根目录及子目录，确认没有commands.py、discord.py、core.py这类与discord.ext.commands内部模块重名的文件，若有立即重命名或删除。

• 重装discord.py包
  打开终端执行以下命令：

  pip uninstall discord.py
  pip cache purge
  pip install discord.py
  

• 确认Python环境一致性
  通过VS Code左下角的Python版本选择器，切换到与台式机一致的Python3.11解释器，避免环境混用导致依赖异常。

• 清理项目缓存
  删除项目目录下所有__pycache__文件夹，清除旧的编译缓存对新代码的干扰。

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