IntelliJ IDEA无法加载Docker Compose依赖：Python Django导入报错

你已通过Docker Compose配置远程Python解释器，但代码包导入仍显示红色波浪线，可按以下步骤排查解决：

1. 验证容器内依赖是否安装完整 #

进入app服务容器，检查项目依赖是否正确安装：

# 先通过docker ps获取app容器ID/名称
docker exec -it <app-container-id/name> bash
# 查看已安装的Python包列表
pip list

确认Django及项目所需依赖已出现在列表中。同时检查你的Dockerfile是否在DEV=true构建参数下执行了依赖安装命令（比如pip install -r requirements.txt），因为你的docker-compose.yml中传递了DEV=true的build参数。

2. 确认IDE远程解释器配置正确性 #

• 检查IDE中选中的解释器是否对应docker-compose.yml里的app服务，而非db或其他服务。
• 验证目录映射：确保IDE识别到容器内的/app目录与本地./app目录正确关联，且该目录被设置为项目根目录。

3. 触发IDE重新同步与索引 #

• 等待IDE完成远程环境的包索引（首次配置远程解释器可能需要几分钟）。
• 手动刷新IDE缓存：以PyCharm为例，执行File -> Invalidate Caches...，勾选"Clear file system cache and local history"后重启IDE，让IDE重新索引远程环境的依赖。

4. 检查Python路径配置 #

在IDE的解释器设置中，确认容器内的Python路径正确（比如/usr/local/bin/python），同时验证容器内的/app目录已加入Python的sys.path：

# 在容器内执行Python代码
import sys
print(sys.path)

如果/app不在列表中，可在IDE的解释器配置里手动将该路径标记为源码根目录。

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