目录

  1. 安装前的准备
  2. 安装 Django
  3. 验证 Django 安装
  4. 创建 Django 项目
  5. 运行 Django 开发服务器
  6. 安装特定 Django 版本
  7. 卸载 Django
  8. 常见安装问题及解决方案
  9. 参考资料

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

激活虚拟环境:

  • Windowsvenv\Scripts\activate
  • macOS / Linuxsource 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/

9. 参考资料

出站链接

站内链接