本文首发于知乎https://zhuanlan.zhihu.com/p/486779329，禁止转载。

1. 创建django项目

可通过如下命令创建名为myproject的django项目，

django-admin startproject myproject
cd myproject
python manage.py migrate

备注

python manage.py migrate意思是把数据模型（Python中定义的Model）和数据库同步。
python manage.py makemigrations是当模型的相关代码发生变动时，对变动进行提交保存，后接migrate

2. 创建app

python manage.py startapp base # 这里base就是app的名字

创建完成后要注册app，在setting.py中找到INSTALLED_APPS，加入app名

INSTALLED_APPS = [
    'base',
    ...
]

一个django项目的结构如下

django项目结构.png

3. 创建数据模型（Model）

在models.py中，建立数据模型，类似于pojo，即一个对象包含哪些字段

from django.db import models

# Create your models here.
class Item(models.Model):
    name = models.CharField(max_length=200)
    created = models.DateTimeField(auto_now_add=True)

如上所述，数据模型变动后，要进行迁移

python manage.py makemigrations
python manage.py migrate

makemigrations后，即建立了数据模型和数据库的联系，可以通过python manage.py sqlmigrate base 0001生成sql语句，但这只是供查看确认，并不执行，migrate才是执行。

临时加入数据

可以另外开一个shell进行一些操作，比如添加数据

python manage.py shell

这条命令相比直接运行python，可以导入该django项目的环境变量。

在shell中添加数据

>>> from base.models import Item
>>> Item.objects.create(name='item1')

>>> Item.objects.create(name='item2')

>>> Item.objects.create(name='item3')

>>> items = Item.objects.all()
>>> print(items)
, , ]>
# 也可以这样
>>> item = Item(name='item4')
>>> item.save()

4. 创建后端逻辑（View）

在views.py文件中完成

比如最简单的，

def home(request):
    return HttpResponse("home page")

这样后续执行该逻辑时，网页上就显示了home page这行字。

当然，更一般的，后端会提供一些数据处理，并显示在定义好的前端模板上，这样就要和前端模板绑定。比如现在要把所有的物品显示在前端页面上，那么后端就要从数据库拉取所有的items，

def get_items(request):
    items = Item.objects.all()
    return render(request, 'items.html', {'items': items})

这样就可以把items数据传递给items.html这个前端模板。

5. 创建前端模板（templates）

在base文件夹下创建templates文件夹，再在templates文件夹下创建base文件夹，并在其中新建items.html文件，即base/templates/base/items.html，这样设置后，在django项目中，我们可以通过base/items.html定位到这个模板。

Django框架中存在模板寻找器，可搜索每个app的特定文件夹。

文件内容如下




    
    
    
    Items


    
        {% for item in items %}
        {{item.name}}
        {% endfor %}

大意就是把各个物品的名字显示成一个无序列表。

6. 绑定网址

以上已经完成了后端与数据库、前端与后端的数据传递，那么用户如何访问这样一个网页呢？就需要在urls.py中绑定好网址和后端。

在base文件夹下新建urls.py文件，内容如下

from . import views 
from django.urls import path

urlpatterns = [
    path("items/", views.get_items),
    path("", views.home)
]

但这个url目前只在base这个app下，并没有被django项目所识别，因此，需要在myproject/urls.py文件中进行引用，以让项目进行识别。

from django.urls import include # 这是新增的行

urlpatterns = [
    path('admin/', admin.site.urls),
    path('base/', include('base.urls'))  # 这是新增的行
]

7. 运行

最后，执行python manage.py runserver即可运行网站，打开http://127.0.0.1:8000/base/items/ 就显示了物品列表如下。

基本Django项目结果.png

8. 参考

Django Crash Course - Introduction + Python Web Development Tutorial
Django REST Framework Oversimplified

基本Django项目构建