一、安装配置Python环境及配置Python环境变量
1、python安装包安装后,需要注意pip.exe和pip3.exe的安装;
2、环境变量需要配置两个目录;
3、验证python是否安装成功
通过cmd命令执行:python --version 查看python版本,如果版本对了则安装成功了。
如果版本不对,或者没有需要多留意环境变量的配置,多版本时需要注意环境变量配置位置的先后及配置之后需要重启电脑。
二、安装配置VSCode并安装Python插件
1、安装VSCode
下载可参考:VSCode下载地址
注意安装的是VSCode(默认蓝色图标---图下)并非VS(默认紫色图标---图上)
2、安装Python插件
安装后,我这边已安装插件如图:
3、安装Django框架
在VSCode终端执行命令:
pip3 install Django 即可安装最新的Django框架
三、在VSCode中建立Django项目
1、初始化Django项目
1)打开终端
2)执行命令:django-admin startproject backend
其中:backend 是自己命名的项目名称
执行完之后生成如下文件:
2、编译及运行Django
在终端运行如下语句:
cd backend
python manage.py runserver
此时目录中多出一些文件:
打开对应网址:http://127.0.0.1:8000/
常见错误及处理一(访问主页面出错)
此时访问Django对应的管理页面http://127.0.0.1:8000/admin/会出现报错:
从错误中,我们知道缺少表auth_user,回过头来,我们并未在哪个过程中初始化过相应的表及字段。只是创建了db.sqlite3数据库,但是并未连接后端数据库及对应表。
四、连接后端数据库
1、将数据库映射到模型(inspectdb
)
在终端执行:
python manage.py inspectdb
命令来自动生成数据库模型 (数据库到模型)
eg:python manage.py inspectdb > novel/models.py
注意目录路径是 "/"
执行后生成如下数据:
执行后在运行时可能出现!!!找不到对应的表的情况,遇到两个点:
常见问题及处理二(找不到对应的表)
1.1、添加自己的APP
需要手动追加 app_label = 'novel' novel是项目名称,需要在配置文件settings.py文件的INSTALLED_APPS中添加。如下图:
1.2、编码格式错误
models.py文件编码格式异常,我这里默认生成的编码格式是:UTF-8-BOM,会导致“ ValueError: source code string cannot contain null bytes”错误。需要通过Notepad++等修改为UTF-8格式编码。
1.3、缺少主键
创建的模型和数据库里面正常情况下都需要有主键,主键示例:
说明:上图中已经手动增加主键,便于我们查看模型中主键创建代码。
通过表创建的模型,如果表中主键正常,主键字段名称为id,默认存在主键并不显示,但是在编译时会提示没有主键的警告。
2、将模型映射到数据库(migrate)
python manage.py migrate 同步数据库以创建相应的表 (模型到数据库)
生成对应的表及数据结构:
3、创建超级用户(createsuperuser )
在终端执行:python manage.py createsuperuser 依据提示及要求生成对应超级管理员账号;
重新运行:python manage.py runserver
四、登录Django后端管理
登录后端管理页面:http://127.0.0.1:8000/admin/
添加新的用户后,在后台数据库表中可以看到:
其中一条是通过命令createsuperuser得到的,一条是通过后端管理插入的。
五、编写对外接口
1、编写路由
图中:admin/是系统默认的管理路由,不要轻易修改;之后的是用户自定义路由。
注意:这里如果有“/”在调用时也需要“/”
2、编写视图
在路由界面通过from 包名 import 类名的方式调用到视图
在视图中通过:@csrf_exempt 标记一个视图(view)函数或类视图(class-based view)为不需要CSRF(跨站请求伪造)保护,使得本地譬如postman通过127.0.0.1也能访问。
通过:@require_http_methods(["GET"]) 指定函数调用方式。
通过修改返回值:譬如:response["Access-Control-Allow-Origin"] = "*" 来满足前端需求,增加此回应是为满足Ant Design Vue Pro前端的安全验证