1. 准备环境
在开始之前,确保你的开发环境满足以下要求:
- 安装了 Python (推荐 3.8 或更高版本)。
- 安装
pip
包管理工具。 - 如果要使用 MySQL 或 PostgreSQL,确保对应的数据库已安装。
创建虚拟环境
在项目目录中创建并激活虚拟环境,保证项目依赖隔离:
# 创建虚拟环境
python -m venv env
# 激活虚拟环境
# Windows
envScriptsactivate
# Linux/Mac
source env/bin/activate
2. 安装 Django 和数据库驱动
在激活的虚拟环境中安装 Django:
pip install django
如果使用 MySQL 或 PostgreSQL,还需要安装相应的驱动:
-
MySQL: 安装
mysqlclient
:pip install mysqlclient
-
PostgreSQL: 安装
psycopg2
:pip install psycopg2-binary
如果只是使用 SQLite,Django 默认支持,无需额外安装。
3. 创建 Django 项目
使用 django-admin
创建一个新的项目:
django-admin startproject myproject
项目结构
创建后,项目的基本结构如下:
myproject/
manage.py # 项目管理脚本
myproject/
__init__.py # 包标识
settings.py # 项目设置
urls.py # URL 配置
asgi.py # ASGI 配置
wsgi.py # WSGI 配置
4. 配置数据库
打开 myproject/myproject/settings.py
,找到 DATABASES
配置项,根据数据库类型修改配置:
默认的 SQLite 配置
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'db.sqlite3',
}
}
使用 MySQL
如果你使用 MySQL,修改为:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'your_database_name',
'USER': 'your_database_user',
'PASSWORD': 'your_database_password',
'HOST': 'localhost', # 数据库主机地址,通常是 localhost
'PORT': '3306', # MySQL 默认端口
}
}
使用 PostgreSQL
如果你使用 PostgreSQL,修改为:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'your_database_name',
'USER': 'your_database_user',
'PASSWORD': 'your_database_password',
'HOST': 'localhost', # 数据库主机地址,通常是 localhost
'PORT': '5432', # PostgreSQL 默认端口
}
}
5. 创建 Django 应用
在项目目录中创建一个新的 Django 应用:
python manage.py startapp myapp
应用结构
创建后,应用的结构如下:
myapp/
migrations/ # 数据库迁移文件目录
__init__.py
__init__.py # 包标识
admin.py # 管理后台配置
apps.py # 应用配置
models.py # 数据模型定义
tests.py # 单元测试
views.py # 视图函数
6. 配置应用
打开 myproject/myproject/settings.py
,在 INSTALLED_APPS
中添加你的新应用:
INSTALLED_APPS = [
# Django 自带的应用
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'dja