PyCharm调试FastAPI时出现Pydantic模块名错误求助

可能的原因及对应解决步骤 #

1. 排查文件名冲突 #

• 绝对不要将你的脚本文件命名为pydantic.py或main.py这类与Pydantic内部模块重名的名称，立刻重命名脚本（比如改为fastapi_demo.py或main_app.py），避免导入逻辑被混淆。

2. 修正PyCharm调试配置 #

• 打开右上角运行配置下拉框，选择Edit Configurations...进入调试配置窗口
• 找到对应的Python调试配置，检查Working directory是否设置为项目根目录，而非脚本所在子目录
• 确认Python interpreter选择的是你安装FastAPI、Pydantic的虚拟环境，避免全局环境依赖混乱

3. 重装依赖并刷新IDE缓存 #

• 在PyCharm终端激活虚拟环境，执行命令更新依赖：

  pip install --upgrade fastapi pydantic uvicorn
  

• 点击顶部菜单File -> Invalidate Caches...，选择Invalidate and Restart，让IDE重新加载依赖信息

4. 标记项目源码根目录 #

• 右键点击项目根目录，选择Mark Directory as -> Sources Root，确保PyCharm能正确识别模块导入路径

代码验证 #

你的代码本身无问题：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def root():
    return {"message": "Hello World"}

报错核心是PyCharm调试时的路径识别或文件名冲突问题，按上述步骤排查即可解决。

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