跳到主要内容

Django 安装配置

介绍

Django 是一个高级 Python Web 框架,它鼓励快速开发和干净、实用的设计。它使开发者能够快速构建复杂的、数据库驱动的网站。在开始使用 Django 之前,首先需要正确安装和配置它。本文将引导你完成 Django 的安装和基本配置过程。

安装 Python

Django 是一个 Python 框架,因此首先需要确保你的系统上安装了 Python。Django 3.2 及以上版本需要 Python 3.6 或更高版本。

检查 Python 版本

在终端或命令提示符中运行以下命令来检查 Python 版本:

bash
python --version

如果显示的是 Python 2.x 版本,请尝试使用 python3 命令:

bash
python3 --version

安装 Python

如果你的系统上没有安装 Python,或者版本过低,可以从 Python 官方网站 下载并安装最新版本。

创建虚拟环境

在安装 Django 之前,建议先创建一个虚拟环境。虚拟环境是一个独立的 Python 环境,可以避免不同项目之间的依赖冲突。

创建虚拟环境

在终端中运行以下命令来创建虚拟环境:

bash
python -m venv myenv

这将创建一个名为 myenv 的虚拟环境目录。

激活虚拟环境

在 Windows 上,使用以下命令激活虚拟环境:

bash
myenv\Scripts\activate

在 macOS 或 Linux 上,使用以下命令:

bash
source myenv/bin/activate

激活后,你的终端提示符会显示虚拟环境的名称,表示你已经进入了虚拟环境。

安装 Django

在虚拟环境中,使用 pip 来安装 Django:

bash
pip install django

安装完成后,可以通过以下命令检查 Django 是否安装成功:

bash
python -m django --version

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

创建 Django 项目

安装 Django 后,可以创建一个新的 Django 项目。Django 项目是一个包含多个应用程序的容器,每个应用程序负责处理特定的功能。

创建项目

在终端中运行以下命令来创建一个新的 Django 项目:

bash
django-admin startproject myproject

这将创建一个名为 myproject 的目录,其中包含 Django 项目的基本结构。

项目结构

进入 myproject 目录,你会看到以下结构:

myproject/
manage.py
myproject/
__init__.py
settings.py
urls.py
asgi.py
wsgi.py
  • manage.py:一个命令行工具,用于管理 Django 项目。
  • myproject/settings.py:项目的配置文件。
  • myproject/urls.py:项目的 URL 配置。

运行开发服务器

Django 自带一个轻量级的开发服务器,可以用于本地开发和测试。

启动服务器

在项目根目录下运行以下命令来启动开发服务器:

bash
python manage.py runserver

默认情况下,服务器会运行在 http://127.0.0.1:8000/。打开浏览器并访问该地址,你应该会看到 Django 的欢迎页面。

配置数据库

Django 默认使用 SQLite 数据库,这对于开发和测试来说已经足够了。如果你需要更强大的数据库,可以在 settings.py 中配置其他数据库。

配置 SQLite

settings.py 中,找到 DATABASES 配置项:

python
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'db.sqlite3',
}
}

这是默认的 SQLite 配置,Django 会自动创建一个 SQLite 数据库文件 db.sqlite3

迁移数据库

在首次运行项目时,需要迁移数据库以创建必要的表:

bash
python manage.py migrate

这将应用 Django 的默认迁移文件,创建数据库表。

创建超级用户

Django 提供了一个内置的管理界面,可以用于管理网站内容。为了访问管理界面,需要创建一个超级用户。

创建超级用户

运行以下命令来创建超级用户:

bash
python manage.py createsuperuser

按照提示输入用户名、电子邮件和密码。创建完成后,访问 http://127.0.0.1:8000/admin/,使用刚刚创建的超级用户登录。

总结

通过本文,你已经学会了如何安装和配置 Django,并创建了一个简单的 Django 项目。Django 的强大功能和易用性使其成为构建 Web 应用程序的理想选择。接下来,你可以继续学习如何创建 Django 应用程序、处理 URL 路由、编写视图和模板等。

附加资源

练习

  1. 尝试在 settings.py 中配置 MySQL 或 PostgreSQL 数据库。
  2. 创建一个新的 Django 应用程序,并将其添加到项目中。
  3. 探索 Django 的管理界面,并尝试添加一些数据模型。