PyCharm中导入标准模块类/函数报错问题求助

• 确认PyCharm已正确关联Poetry虚拟环境
  打开File > Settings > Project: [你的项目名] > Python Interpreter，检查选中的解释器是否为Poetry生成的虚拟环境（路径通常是~/.cache/pypoetry/virtualenvs/[项目标识]-py3.10或项目根目录下的.venv）。如果没找到，点齿轮图标选择Add > Poetry Environment，手动指定虚拟环境路径。

• 彻底重建PyCharm项目索引
  执行File > Invalidate Caches...，选择Invalidate and Restart。这会清空缓存并重启PyCharm，强制重新扫描整个项目的依赖和代码结构，比单纯清缓存更有效。

• 验证Poetry依赖的完整性
  进入项目根目录终端，执行poetry run pip list，确认pydantic等有问题的包已正确安装在当前环境。如果依赖状态异常，执行poetry lock --no-update && poetry install，重新同步锁文件并安装依赖。

• 排查包版本迭代导致的导入路径变化
  部分包的核心类/函数会随版本迁移，比如pydantic v2中BaseSettings已移至pydantic-settings独立包。执行poetry show pydantic查看版本，若为v2+，需执行poetry add pydantic-settings，并将导入语句改为from pydantic_settings import BaseSettings。

• 检查解释器路径配置细节
  在Python Interpreter设置中点击Show All，选中对应Poetry环境后点Edit，确认Interpreter path指向虚拟环境内的Python可执行文件，同时在Paths标签页确认虚拟环境的site-packages目录已被添加到解析路径中。

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