Django 安装与配置

开始之前

在安装Django之前，请确保您已经安装了Python。Django 3.2及更高版本需要Python 3.8+。

安装概述

Django的安装过程包括以下几个主要步骤：

  1. 检查Python版本 - 确保您的系统安装了兼容的Python版本
  2. 创建虚拟环境（推荐） - 隔离项目依赖
  3. 安装Django - 使用pip安装Django包
  4. 验证安装 - 确认Django正确安装
  5. 创建项目 - 开始您的第一个Django项目

系统要求

Python版本要求
✓ Django 4.2+: Python 3.8+
✓ Django 4.1: Python 3.8+
✓ Django 4.0: Python 3.8+
✓ Django 3.2: Python 3.6+
数据库支持
✓ PostgreSQL
✓ MySQL
✓ SQLite
✓ Oracle

详细安装步骤

1. 检查Python安装

打开命令提示符(CMD)或PowerShell，运行以下命令检查Python版本：

> python --version

如果显示Python 3.8或更高版本，则可以继续。如果未安装Python，请从Python官网下载并安装。

2. 创建虚拟环境（推荐）

虚拟环境可以隔离项目依赖，避免包冲突：

> python -m venv myenv
> myenv\Scripts\activate

激活虚拟环境后，命令提示符前会显示(myenv)。

3. 安装Django

使用pip安装Django：

(myenv)> pip install django

要安装特定版本，可以使用：

(myenv)> pip install django==4.2.0

1. 检查Python安装

打开终端，运行以下命令检查Python版本：

$ python3 --version

如果显示Python 3.8或更高版本，则可以继续。如果未安装Python，可以使用Homebrew安装：

$ brew install python

2. 创建虚拟环境（推荐）

创建并激活虚拟环境：

$ python3 -m venv myenv
$ source myenv/bin/activate

激活虚拟环境后，命令提示符前会显示(myenv)。

3. 安装Django

使用pip安装Django：

(myenv) $ pip install django

1. 检查Python安装

打开终端，运行以下命令检查Python版本：

$ python3 --version

如果显示Python 3.8或更高版本，则可以继续。如果未安装Python，可以使用包管理器安装：

Ubuntu/Debian:

$ sudo apt update
$ sudo apt install python3 python3-pip

CentOS/RHEL:

$ sudo yum install python3 python3-pip

2. 创建虚拟环境（推荐）

首先安装venv包（如果需要）：

$ sudo apt install python3-venv # Ubuntu/Debian

然后创建并激活虚拟环境：

$ python3 -m venv myenv
$ source myenv/bin/activate

3. 安装Django

使用pip安装Django：

(myenv) $ pip install django

验证安装

安装完成后，可以通过以下方式验证Django是否正确安装：

$ python -m django --version

如果安装成功，将显示Django的版本号。

或者，在Python交互式环境中导入Django：

>>> import django
>>> django.get_version()
'4.2.0'

创建第一个Django项目

1. 创建项目

使用django-admin命令创建新项目：

$ django-admin startproject mysite

这将创建一个名为mysite的目录，包含基本的Django项目结构。

2. 项目结构

创建的项目将具有以下结构：

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

3. 运行开发服务器

进入项目目录并启动开发服务器：

$ cd mysite
$ python manage.py runserver

在浏览器中访问 http://127.0.0.1:8000/，您将看到Django的欢迎页面。

基本配置

settings.py 配置文件

Django项目的主要配置位于mysite/settings.py文件中。以下是一些重要的配置项：

配置项 说明 示例
DEBUG 调试模式，开发时设置为True，生产环境必须设置为False DEBUG = True
ALLOWED_HOSTS 允许访问的主机/域名，生产环境必须设置 ALLOWED_HOSTS = ['example.com', 'localhost']
DATABASES 数据库配置，默认使用SQLite DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.sqlite3',
    'NAME': BASE_DIR / 'db.sqlite3',
  }
}
INSTALLED_APPS 已安装的应用程序列表 INSTALLED_APPS = [
  'django.contrib.admin',
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.messages',
  'django.contrib.staticfiles',
  'myapp', # 自定义应用
]
STATIC_URL 静态文件URL STATIC_URL = '/static/'

常见问题与故障排除

1. "python: command not found" 错误

原因：Python未安装或未添加到系统PATH。

解决方案：

  • 确保已从Python官网下载并安装Python
  • 在安装过程中勾选"Add Python to PATH"选项
  • 尝试使用python3命令代替python
2. "pip: command not found" 错误

原因：pip包管理器未安装。

解决方案：

  • 确保Python安装包含pip（现代Python版本默认包含）
  • 手动安装pip：python -m ensurepip --default-pip
  • 或下载并运行get-pip.py
3. 端口已被占用错误

原因：默认端口8000已被其他进程使用。

解决方案：

  • 使用不同端口：python manage.py runserver 8080
  • 查找并终止占用端口的进程
4. 数据库迁移错误

原因：首次运行项目时需要进行数据库迁移。

解决方案：

  • 运行迁移命令：python manage.py migrate
  • 创建超级用户：python manage.py createsuperuser
上一章: Django简介 下一章: 创建Django项目