django项目必须配置独立python虚拟环境,否则会导致多项目依赖冲突、版本混用及隐性运行错误;推荐python 3.3+用户使用python -m venv .venv创建隔离环境。

直接用 pip install django 就行,不需要额外参数或环境准备(前提是已装好 Python 和 pip)。
为什么不是 pip3 install django?
在绝大多数现代 Python 安装中(尤其是 3.6+),pip 默认指向 Python 3 的包管理器。只有当系统同时装了 Python 2 和 3、且 pip 仍指向 Python 2 时,才需要明确写 pip3。但 Python 2 已于 2020 年停止维护,Django 4.0+ 也已不支持 Python 2 —— 所以你现在用的几乎肯定是 pip 对应 Python 3。
- 检查方式:
pip --version输出里带python 3.x就没问题 - 如果报错
command not found,说明 pip 没进 PATH,不是命令写错,而是 Python 安装时没勾选Add Python to PATH
指定版本安装怎么写?
用双等号 ==,不是单等号或空格:
pip install django==5.2.5
常见错误写法:pip install django = 5.2.5(语法错误)、pip install django-5.2.5(会当成另一个包名)。
- Django 5.x 要求 Python ≥ 3.10;如果你用的是 Python 3.9,装
django==4.2.18更稳妥 - 教程里写的
1.11.9或2.2.4等老版本,现在装了也跑不起来——Python 版本或依赖库早已不兼容
安装后验证是否成功?
别只信 pip list 里有 Django,要实际导入试试:
python -c "import django; print(django.get_version())"
或者更直接:
django-admin --version
如果报错 command not found 或 'django-admin' is not recognized,说明 Scripts 目录没进系统 PATH(Windows 常见),不是 Django 没装上。
- 临时解决:进到 Python 安装路径下的
Scripts目录再运行django-admin - 永久解决:把
C:\Users\XXX\AppData\Local\Programs\Python\Python312\Scripts(路径按你实际 Python 版本调整)加进系统环境变量 PATH
最容易被忽略的一点:Django 安装本身极少失败,但后续 django-admin startproject 报错,90% 是因为 PATH 没配对,而不是 Django 没装好。











