PyCharm中导入Django模块提示Unresolved reference问题求助

确认Python解释器关联正确 #

• 打开PyCharm的File > Settings > Project: [你的项目名] > Python Interpreter
• 查看已安装包列表：
  • 若没有Django，点击+搜索Django，选择和教程匹配的版本安装
  • 若已有Django，确认当前选中的解释器是你创建项目时用的虚拟环境（比如项目根目录下venv文件夹里的Python可执行文件，而非系统全局Python）

刷新PyCharm索引缓存 #

• 点击File > Invalidate Caches...，选择Invalidate and Restart，重启后PyCharm会重新扫描项目依赖，多数情况下红色波浪线会自动消失

检查项目根目录标记 #

• 右键项目根目录，选择Mark Directory as > Sources Root，确保项目源码目录被正确识别
• 也可进入Settings > Project Structure，确认虚拟环境的site-packages目录（Django安装在此）已添加到项目内容根目录

手动指定Django路径（极端场景） #

• 找到Django的安装路径（虚拟环境下一般为项目根目录/venv/Lib/site-packages/django）
• 打开Settings > Project Structure，点击Add Content Root，选中该路径并设置为Sources，强制PyCharm识别该依赖

内容的提问来源于stack exchange，提问作者Mikkel hein Wadsholt