目录
- 安装前的准备
- 安装 Django
- 验证 Django 安装
- 创建 Django 项目
- 运行 Django 开发服务器
- 安装特定 Django 版本
- 卸载 Django
- 常见安装问题及解决方案
- 参考资料
1. 安装前的准备
在安装 Django 之前,确保你已经安装了 Python 3.6+(建议使用 Python 3.10 或以上)。
检查 Python 版本
在终端(Windows 终端 / macOS 终端 / Linux 终端)运行:
python --version
或者
python3 --version
如果 Python 版本低于 3.6,请先下载并安装 Python。
安装 pip(Python 包管理器)
运行以下命令检查 pip 是否已安装:
pip --version
如果未安装,可使用以下命令安装(或更新):
python -m ensurepip --default-pip
python -m pip install --upgrade pip
2. 安装 Django
建议在 虚拟环境(Virtual Environment) 中安装 Django,以避免影响全局 Python 依赖。
2.1 创建虚拟环境(可选)
在项目目录下运行:
python -m venv venv
激活虚拟环境:
- Windows:
venv\Scripts\activate
- macOS / Linux:
source venv/bin/activate
2.2 使用 pip 安装 Django
pip install django
这将安装最新的 Django 版本。
3. 验证 Django 安装
安装完成后,运行以下命令检查 Django 版本:
django-admin --version
如果显示 Django 版本号(如 4.2.3
),说明安装成功。
4. 创建 Django 项目
使用 django-admin startproject
命令创建 Django 项目:
django-admin startproject myproject
cd myproject
目录结构如下:
myproject/
│── manage.py # Django 项目管理文件
│── myproject/ # 项目主目录
│ ├── __init__.py
│ ├── settings.py # 项目配置
│ ├── urls.py # 路由
│ ├── asgi.py
│ └── wsgi.py
5. 运行 Django 开发服务器
在项目目录下运行:
python manage.py runserver
默认情况下,Django 服务器会运行在 http://127.0.0.1:8000/
。
打开浏览器访问 **http://127.0.0.1:8000/**,如果看到 Django 欢迎页面,表示安装和配置成功。
6. 安装特定 Django 版本
如果需要安装特定版本的 Django,例如 Django 3.2(LTS 版本),可以运行:
pip install django==3.2
或者安装 Django 4.1:
pip install django==4.1
检查可用版本:
pip install django==
(输入 ==
后按 Tab
键会列出可安装的版本)
7. 卸载 Django
如果需要卸载 Django,可以使用:
pip uninstall django
8. 常见安装问题及解决方案
1. pip 版本过旧导致安装失败
错误信息:
ERROR: Could not find a version that satisfies the requirement django
解决方案:
python -m pip install --upgrade pip
2. “django-admin: command not found”(找不到 django-admin)
原因:可能未正确安装 Django 或未激活虚拟环境。
解决方案:
- 重新安装 Django:
pip install django
- 在 macOS/Linux 上,如果
django-admin
命令无法找到,尝试:python -m django --version
3. 端口 8000 被占用
错误信息:
Error: That port is already in use.
解决方案:
- 指定新的端口:
python manage.py runserver 8080
然后访问http://127.0.0.1:8080/
。
发表回复