DjangoStarter 项目教程
1. 项目的目录结构及介绍
DjangoStarter/
├── app/
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── migrations/
│ ├── models.py
│ ├── tests.py
│ └── views.py
├── config/
│ ├── __init__.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
├── manage.py
├── requirements.txt
└── README.md
目录结构介绍
-
app/: 包含项目的应用代码,通常包含模型、视图、管理界面等。
__init__.py
: 使app
成为一个 Python 包。admin.py
: 定义应用在 Django 管理界面的行为。apps.py
: 应用的配置文件。migrations/
: 存储数据库迁移文件。models.py
: 定义应用的数据模型。tests.py
: 编写应用的测试代码。views.py
: 定义应用的视图函数。
-
config/: 包含项目的配置文件。
__init__.py
: 使config
成为一个 Python 包。settings.py
: 项目的全局配置文件,包含数据库配置、静态文件路径等。urls.py
: 项目的 URL 路由配置。wsgi.py
: 用于部署项目的 WSGI 配置文件。
-
manage.py: Django 项目的管理脚本,用于运行服务器、创建应用、执行迁移等。
-
requirements.txt: 列出项目依赖的 Python 包。
-
README.md: 项目的说明文档。
2. 项目的启动文件介绍
manage.py
manage.py
是 Django 项目的管理脚本,提供了许多用于管理项目的命令。以下是一些常用的命令:
-
启动开发服务器:
python manage.py runserver
-
创建应用:
python manage.py startapp <app_name>
-
执行数据库迁移:
python manage.py makemigrations python manage.py migrate
-
创建超级用户:
python manage.py createsuperuser
3. 项目的配置文件介绍
config/settings.py
settings.py
是 Django 项目的全局配置文件,包含了许多重要的配置项。以下是一些关键配置项的介绍:
-
数据库配置:
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / 'db.sqlite3', } }
-
静态文件路径:
STATIC_URL = '/static/' STATICFILES_DIRS = [BASE_DIR / "static"]
-
模板路径:
TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [BASE_DIR / "templates"], 'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ 'django.template.context_processors.debug', 'django.template.context_processors.request', 'django.contrib.auth.context_processors.auth', 'django.contrib.messages.context_processors.messages', ], }, }, ]
-
时区配置:
TIME_ZONE = 'Asia/Shanghai' USE_TZ = True
config/urls.py
urls.py
是项目的 URL 路由配置文件,定义了 URL 与视图函数的映射关系。以下是一个简单的示例:
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('app.urls')),
]
config/wsgi.py
wsgi.py
是用于部署项目的 WSGI 配置文件,定义了如何与 WSGI 服务器进行交互。通常不需要手动修改此文件。
import os
from django.core.wsgi import get_wsgi_application
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
application = get_wsgi_application()
通过以上介绍,您应该对 DjangoStarter
项目的目录结构、启动文件和配置文件有了基本的了解。希望这些信息能帮助您更好地理解和使用该项目。