PyCharm 配置 Django 环境需满足三个前提：Python 解释器就位、Django 包已安装、项目含 manage.py；专业版新建 Django 项目可自动完成环境搭建，社区版须手动配置；关键设置包括启用 Django 支持、正确填写 DJANGO_SETTINGS_MODULE、设置工作目录及解释器路径。
PyCharm 能直接识别并配置 Django 环境，但必须满足三个硬性前提：Python 解释器已就位、Django 包已安装、项目结构含 manage.py —— 缺一不可，否则所有后续配置都会失败。
PyCharm 新建项目时选 Django 模板是否可靠？
可靠，但仅限专业版；社区版不提供该选项。专业版新建项目时左侧选 Django，PyCharm 会自动执行：django-admin startproject、创建虚拟环境、安装 django 包，并预设好 manage.py 路径和运行配置。社区版用户必须手动完成这些步骤，否则点“运行”会报 ModuleNotFoundError: No module named 'django' 或找不到 manage.py。
常见错误现象：
- 新建项目后右上角运行按钮灰掉 → 未标记 Sources Root 或没识别到
manage.py - 点击运行提示
Command 'runserver' not found→Django未装进当前解释器，或DJANGO_SETTINGS_MODULE未设置
为什么 manage.py 找得到，却启动不了开发服务器？
根本原因通常是 DJANGO_SETTINGS_MODULE 环境变量缺失或路径错误。PyCharm 的 Django Server 运行配置里必须显式填写这项，格式为 projectname.settings（其中 projectname 是你用 django-admin startproject 创建的最外层包名，不是项目文件夹名）。
实操建议：
- 检查
settings.py是否真在projectname/projectname/settings.py路径下（注意嵌套一层） - 在 PyCharm 的
Run → Edit Configurations → Django Server中，Environment variables字段填：DJANGO_SETTINGS_MODULE=projectname.settings -
Working directory必须设为含manage.py的目录，不能是子目录 - 若用虚拟环境，确保
Python Interpreter设置指向该环境下的python，而非系统 Python
BASE_DIR / 'templates' 报错：unsupported operand type(s) for /
这是 Django 4.0+ 和 Python 3.12+ 常见兼容问题。Django 默认用 pathlib.Path 的 / 运算符拼路径，但某些旧版 PyCharm 或自定义 BASE_DIR 定义（比如用字符串拼接）会导致类型冲突。
解决方式不是改写法，而是统一用 pathlib：
from pathlib import Path BASE_DIR = Path(__file__).resolve().parent.parent.parent # 然后 TEMPLATES['DIRS'] 写成 [BASE_DIR / 'templates']
如果仍报错，说明 BASE_DIR 被覆盖成了字符串 —— 检查 settings.py 开头是否有多余赋值，比如误写成 BASE_DIR = os.path.dirname(...)。
最容易被忽略的一点：PyCharm 的 Enable Django support 开关（File → Settings → Languages & Frameworks → Django）一旦关闭，代码跳转、模板语法高亮、manage.py 命令补全全部失效，且不会报错提示 —— 它只是静默退化成普通 Python 项目。务必确认这个复选框是勾选状态。
