python环境需3.9+且pip可用，验证用python --version和pip --version；必须用venv隔离安装django 5.2.10；项目须建在纯英文路径，首次运行前执行migrate并创建superuser。
确认 Python 环境是否就绪
必须先有 Python 3.9+（推荐 3.12），且 pip 可用，否则后续所有操作都会卡在第一步。很多人装完 Python 没勾选 “Add Python to PATH”，导致终端里敲 python 或 pip 直接报“不是内部命令”。
- 打开终端，执行
python --version和pip --version，两行都输出版本号才算过关 - 如果只显示
python成功但pip失败，大概率是安装时 pip 没自动装上，可手动运行python -m ensurepip --upgrade - Windows 用户若用 PowerShell 报错“脚本被禁止执行”，只需运行一次
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（需管理员权限）
用虚拟环境隔离 Django 安装
直接 pip install django 到全局 Python 是最常见、也最危险的起步错误——不同项目可能依赖不同 Django 版本（比如一个要 4.2 LTS，另一个试 5.2），混在一起必然冲突。
- 创建并激活虚拟环境：
python -m venv venv→venv\Scripts\activate.bat（Win）或source venv/bin/activate（macOS/Linux） - 激活后终端提示符前应出现
(venv)，此时再装 Django 才安全 - 装稳定版而非最新版：Django 5.2.10 是当前（2026 年 3 月）LTS 推荐版本，命令为
pip install django==5.2.10 - 验证是否装对了环境：
python -m django --version输出必须是5.2.10，且不能和系统全局版本一致
创建项目：别用 django-admin startproject 直接生成到桌面
命令本身没错，但新手常把项目建在 C:\Users\XXX\Desktop 这类路径下，后面 PyCharm 导入、Git 初始化、部署打包全会出奇怪问题——空格、中文、权限、同步延迟都会干扰。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 先新建一个纯英文路径的父目录，比如
D:\django-projects或~/dev/django - cd 进去再运行：
django-admin startproject mysite（mysite不能叫django或test，会和内置模块冲突） - 生成结构里有两个关键层级：外层
mysite/是项目容器，内层mysite/mysite/才是配置核心（含settings.py、urls.py） - 别删
manage.py——它是项目入口，PyCharm 跑调试、终端启服务、迁移数据库全靠它
启动服务器前必须做的一件事
直接 python manage.py runserver 启动，浏览器打开 http://127.0.0.1:8000/ 却看到 ImproperlyConfigured 错误？八成是跳过了数据库迁移这步——Django admin、auth 等内置功能依赖初始表结构，不迁移就跑不起来。
- 首次运行前务必执行：
python manage.py migrate - 顺手建个超级用户方便进后台：
python manage.py createsuperuser - 端口被占？别硬等，换一个就行：
python manage.py runserver 8001 - 如果页面空白或 404，检查
mysite/settings.py中的DEBUG = True和ALLOWED_HOSTS = ['127.0.0.1']是否已设好
真正容易被忽略的不是命令怎么写，而是每一步背后那个“上下文”：Python 解释器是不是你激活的虚拟环境里的、manage.py 是不是在项目根目录下执行的、settings.py 里的路径变量有没有被手改崩——这些细节不出错，Django 项目才真的算立住了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
