大三的时候第一次接触 Django，从真正使用 Django 做项目到现在也快 4 年了。最喜欢的其实还是 Django 的 ORM 框架。公司的项目都是前后分离的，使用 Django 做后端接口开发还是很高效的。
特此总结一些 Django 开发的小经验。先说一些最最基础的吧。
使用 virtualenv 隔离开发环境
使用 pip 管理项目依赖，主要就是一个小技巧，使用 pip freeze > requirements.txt 来保存依赖的模块和版本
使用 gitignore.io 这个网站提供的 .gitignore 文件管理代码库文件
打包和发布
项目的打包和发布用的 Docker，Django 项目的 Dockerfile 特别简单：
1
2
3
4
5
6
7
FROM python:3.5
COPY ./requirements.txt /src
WORKDIR /src
RUN pip install -r requirements.txt
COPY . /src
EXPOSE
CMD uwsgi --http :--wsgi-file
这一个 Dockerfile 模板可以通吃 80% 的 Django 项目了。
日志配置
既然用 Docker，就放弃了把日志写入文件，直接写到标准输出。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# settings.py
# ...
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'formatters': {
'verbose': {
'format': '[application] %(levelname)s %(asctime)s %(module)s %(message)s'
}
},
'handlers': {
'console': {
'level': 'DEBUG',
'class': 'logging.StreamHandler',
'stream': sys.stdout,
'formatter': 'verbose'
},
},
'loggers': {
'app': {
'handlers': ['console'],
'level': 'DEBUG',
'propagate': True,
},
},
}
新版本的 uwsgi 已经可以把 webapp 的日志收集起来输出到标准输出里面了。如果需要收集、管理日志的话，就是用 Docker 日志收集工具，直接收集 Docker 容器的日志即可。
自动化测试
既然是纯后端项目，工程师完全可以通过自动化测试来检测自己的代码。Django 本身对测试提供了很好的支持，可以通过 sqlite 来搭建测试数据库，还有基于内存的缓存，做测试不会增加对其他系统的依赖。开发起来事半功倍。
除了要写自动化测试代码，还要能统计测试覆盖率。目前我们用的是 coverage.py 这个工具，说实话没有 node.js 的 istanbul 好用，输出的报告没有 Istanbul 详细和易读。不过用来检查 “死代码” 还是够用的。
针对 http 代码的测试
有些项目需要对接的第三方系统比较多，比如微信认证、支付、短信等常见的，可能还有其他一些垂直业务领域的系统。这部分接口对接的代码，也应该纳入到测试当中，毕竟 Python 作为脚本语言，代码很容易出现错误。
这块一般是用 responses 这个模块来 mock http 请求。
定时任务
有一些 Django 项目需要做一些定时任务。首先，绝对不用 linux 内置的 crontab。主要的问题还是维护的成本高，没准哪天就把这个配置给忘了。
我们现在方式都是借助 Django Command 的功能，将定时任务封装成一个 command。在这个 command 里面运行一个 scheduler。就像下面这样：
1
2
3
4
5
6
7
8
9
import schedule
from django.core.management.base import BaseCommand
class Command(BaseCommand):
def handle(self, *args, **kwargs):
schedule.every(45).minutes.do(do_this)
schedule.every().day.at('04:00').do(do_that)
while True:
schedule.run_pending()
time.sleep(1)