PyCharm新建Django项目前必须先安装Django，否则报ModuleNotFoundError；启动失败常见于端口占用或ROOT_URLCONF路径错误；需手动启用Django支持并正确配置项目根目录、settings.py和manage.py路径。
PyCharm新建项目时选Django模板，但没装Django会失败
PyCharm的「New Project」界面里点左侧Django选项，本质是调用 django-admin startproject，但它**不自动安装Django**。如果当前Python解释器里没装Django，项目创建直接报错：ModuleNotFoundError: No module named 'django'。
解决办法很简单：先确保解释器已装Django。推荐在新建项目前，用终端手动装一次：
- 打开PyCharm Terminal，运行
pip install Django==5.2.5（用稳定版，避免新版本兼容问题） - 或者，在PyCharm设置里进
File > Settings > Project > Python Interpreter，点+号搜索Django并安装 - 再新建项目时，务必在「Interpreter」下拉菜单中选中这个已装Django的解释器
manage.py runserver 启动失败，常见原因是路径或端口冲突
点PyCharm右上角绿色三角形运行，或终端执行 python manage.py runserver，报错多半不是代码问题，而是环境配置偏差。
典型现象和应对：
-
CommandError: You don't have permission to access that port：说明8000端口被占用。改用python manage.py runserver 8001或查杀占用进程（lsof -i :8000on macOS/Linux，netstat -ano | findstr :8000on Windows） -
ImportError: No module named 'mysite.urls'：检查settings.py中ROOT_URLCONF值是否拼错，比如写成'my_site.urls'而不是项目名实际生成的'mysite.urls' - 启动后浏览器打不开
http://127.0.0.1:8000：确认PyCharm右下角是否显示「Running on http://127.0.0.1:8000」，没显示说明根本没启动成功，回看Terminal输出第一行错误
PyCharm识别不了Django语法，比如models.py里红色波浪线
这不是代码错，是PyCharm没把当前项目当成Django项目处理——它不会自动启用Django支持，哪怕你用Django模板创建的项目。
必须手动开启：
- 进入
File > Settings > Languages & Frameworks > Python Django - 勾选
Enable Django Support -
Django project root选项目根目录（含manage.py的那一层） -
Settings填mysite/settings.py（路径要准确，不能漏掉子目录名） -
Manage script填manage.py
做完这步，models.CharField、path() 这些才会被正确补全和校验。
虚拟环境路径放错位置，导致PyCharm找不到包
很多人在PyCharm里勾选「New environment using Virtualenv」，却把虚拟环境路径设到项目外（比如 C:\venvs\mydjango），结果Django装进去了，但PyCharm新开Terminal默认不激活它，pip list 看不到Django。
稳妥做法：
- 新建项目时，虚拟环境路径设为
./venv（点项目根目录下的venv文件夹） - 这样PyCharm会自动在Terminal里执行
source venv/bin/activate（macOS/Linux）或venv\Scripts\activate（Windows） - 如果已经建好但路径不对，删掉旧venv文件夹，重新在项目根目录下用命令行建：
python -m venv venv，再在PyCharm设置里重新指定解释器路径
路径错一次，后面所有 pip install 都白装——这是新手最常卡住的地方，不是Django难，是环境没对齐。
