Windows下PyCharm中Docker-Compose Django项目配置异常求助

一、PyCharm执行manage.py时的配置错误问题 #

• 检查manage.py运行配置的环境变量：打开「Run/Debug Configurations」，找到对应manage.py的配置项，在「Environment variables」中添加DJANGO_SETTINGS_MODULE，值设为你的Django项目settings路径（例如myproject.settings），同时确认「Working directory」设置为项目根目录（与docker-compose.yml同级）。
• 验证Docker解释器的服务关联：进入「File -> Settings -> Project: [项目名] -> Python Interpreter」，确认选中的是Docker Compose类型的解释器，且对应服务为你的Django容器服务（如docker-compose.yml中的web服务）。若项目使用.env文件管理环境变量，需在解释器配置的「Environment variables」中加载该文件内容，或确保PyCharm读取了docker-compose.yml中定义的环境变量。
• 临时修复（不推荐长期使用）：在manage.py最顶部添加以下代码，手动指定settings模块：

import os
os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')

二、Docker解释器无法识别Django导致代码高亮/补全失效问题 #

• 重新同步解释器依赖：在Python Interpreter页面，点击右上角齿轮图标选择「Show All」，找到对应的Docker Compose解释器，点击刷新图标，让PyCharm重新拉取容器内的依赖列表，确保Django被识别。
• 配置Django项目结构与支持：
  1. 进入「File -> Settings -> Project: [项目名] -> Project Structure」，将Django项目根目录标记为「Sources」（蓝色文件夹），templates文件夹标记为「Templates」。
  2. 进入「Languages & Frameworks -> Django」，勾选「Enable Django support」，分别设置正确的「Django project root」、「Settings file」（如myproject/settings.py）和「Templates folder」路径。
• 清除PyCharm缓存并重启：点击「File -> Invalidate Caches...」，选择「Invalidate and Restart」，让PyCharm重新索引项目，解决缓存导致的识别异常。
• 验证容器内Django安装状态：手动进入容器执行docker exec -it 容器名 bash，再运行pip list确认Django已正确安装，若未安装则检查Dockerfile或requirements.txt是否包含Django依赖。

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