Django 初学者指南：如何安装及创建一个 Django 项目
Django 是一个高效的 Python Web 开发框架，适合快速构建 Web 应用。本指南将带领你从安装 Django 到创建一个基本的 Django 项目。以下是整个流程的步骤概览：
步骤概览
| 步骤 | 描述 |
|---|---|
| 1 | 安装 Python 和 pip |
| 2 | 安装 Django |
| 3 | 创建 Django 项目 |
| 4 | 创建 Django 应用 |
| 5 | 配置数据库 |
| 6 | 启动开发服务器 |
| 7 | 创建模型、视图和模板 |
详细步骤
第一步：安装 Python 和 pip
首先，你需要在你的系统上安装 Python 和 pip（Python 包管理工具）。请访问 [Python 官网]( 进行下载。
安装后，确保 Python 和 pip 可以在命令行中正常使用。你可以通过以下命令来检查：
python --version # 检查 Python 版本
pip --version # 检查 pip 版本
第二步：安装 Django
接下来，通过 pip 安装 Django。打开终端并运行以下命令：
pip install django
这条命令会在你的系统中安装最新的 Django 版本。
第三步：创建 Django 项目
安装完成后，你可以创建一个新的 Django 项目。使用以下命令：
django-admin startproject myproject
此命令会创建一个名为 myproject 的新 Django 项目。项目目录结构如下：
myproject/
manage.py
myproject/
__init__.py
settings.py
urls.py
asgi.py
wsgi.py
第四步：创建 Django 应用
Django 项目可以包含多个应用。我们接下来创建一个新的应用，命名为 myapp。
在项目根目录下运行：
cd myproject
python manage.py startapp myapp
此命令会在项目中创建一个新目录 myapp，其中包含了基本的应用结构。
第五步：配置数据库
在 myproject/settings.py 文件中配置数据库。Django 默认使用 SQLite。你可以直接使用以下默认配置：
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / "db.sqlite3",
}
}
第六步：启动开发服务器
在命令行中执行以下命令以启动 Django 开发服务器：
python manage.py runserver
你将看到输出信息显示服务器正在运行。你可以通过访问 ` 来查看你的 Django 项目。
第七步：创建模型、视图和模板
-
创建模型：在
myapp/models.py文件中定义你的数据模型。from django.db import models class Item(models.Model): name = models.CharField(max_length=100) # 商品名称 price = models.DecimalField(max_digits=10, decimal_places=2) # 商品价格 def __str__(self): return self.name -
迁移模型到数据库：运行以下命令来创建数据库表：
python manage.py makemigrations # 创建迁移 python manage.py migrate # 应用迁移 -
创建视图：在
myapp/views.py文件中定义视图函数。from django.shortcuts import render from .models import Item def item_list(request): items = Item.objects.all() # 查询所有商品 return render(request, 'myapp/item_list.html', {'items': items}) # 渲染模板 -
创建模板：在
myapp/templates/myapp/item_list.html文件中定义基本的 HTML 模板。<!DOCTYPE html> <html> <head> <title>Item List</title> </head> <body> Item List <ul> {% for item in items %} <li>{{ item.name }}: ${{ item.price }}</li> {% endfor %} </ul> </body> </html> -
配置 URL：在
myapp/urls.py文件中设置 URL 路由。from django.urls import path from .views import item_list urlpatterns = [ path('', item_list, name='item_list'), # 路由到 item_list 视图 ]然后记得在
myproject/urls.py中包含myapp的 URL。from django.contrib import admin from django.urls import include, path urlpatterns = [ path('admin/', admin.site.urls), path('', include('myapp.urls')), # 包含 myapp 的 URL ]
类图
这是你所创建的基本结构的类图示意：
classDiagram
class Item {
+String name
+Decimal price
+String __str__()
}
Item --> "1" List
总结
通过上述步骤，你已经成功安装了 Django，创建了一个基本的 Django 项目并构建了一个简单的应用。Django 的强大之处在于其组合和扩展能力，接下来你可以继续深入学习 Django 的其他功能，如用户认证、RESTful API 等。
希望这篇指南能帮助你顺利入门 Django 开发，享受编写代码的乐趣！如有疑问，建议查询 Django 官方文档或相关资源。
