。
| 章节 | 回答的问题 | 关键产出 |
|---|---|---|
| 一、环境与项目骨架 | 一个能长期维护的 Django 工程长什么样 | settings 拆分、sys.path、logger、异常与统一响应 |
| 二、用户与登录 | 用户从哪来、怎么证明他是他 | 扩写 User 表、media、多方式登录、短信登录、注册、CORS |
| 三、Redis 与 Celery | 性能与异步能力从哪来 | 连接池、五大数据类型、三种任务、缓存双写、异步秒杀 |
| 四、课程与视频 | 核心业务表与接口怎么设计 | 五层表关联、列表/详情接口、分页过滤、视频托管 |
| 五、支付宝支付 | 钱怎么收、状态怎么改 | 沙箱下单、get/post 回调、验签、订单状态流转 |
| 六、部署与协作 | 怎么上线、多人怎么不打架 | git 协同与冲突、rebase、部署要点、基础速记 |
一、环境与项目骨架
把后端工程按企业目录搭好,拆分开发 / 上线配置,并封装日志、异常、响应体三件公共组件,后续视图直接复用。
要点
目录分工
| 目录 | 存放内容 |
|---|---|
| apps | 各子应用 |
| libs | 第三方类库、组件 |
| utils | 自开发公共函数与组件 |
| settings | 配置包,分 dev.py 与 prod.py |
| scripts | 项目运营脚本 |
| logs | 运行 / 开发日志 |
- 项目在虚拟环境中创建,先装好对应版本 Django 再 startproject。
- 子应用统一在 apps 目录下创建,再到配置文件注册。
- logs 为包目录,scripts 为普通运营脚本文件夹。
- settings 拆为 dev.py(本地开发)与 prod.py(上线运行)。
- manage.py 是开发入口,指向 dev;wsgi.py、asgi.py 是上线入口,指向 prod。
- sys.path 注入 apps 与内层项目包,注册应用时可直接写应用名。
- BASE_DIR 定位内层项目包目录,路径拼接都以它为基准。
- SECRET_KEY 供 session 加密与密码加密使用,上线不外泄。
- DEBUG 开发开 True,上线改 False;ALLOWED_HOSTS 在 DEBUG=False 时必填。
- INSTALLED_APPS 注册应用,MIDDLEWARE 为中间件链,ROOT_URLCONF 指向总路由。
- 内置应用含 admin、auth、contenttypes、sessions、messages、staticfiles。
- 中间件覆盖安全、session、common、csrf、认证、消息框架、点击劫持防护。
- 国际化用 zh-hans、Asia/Shanghai,USE_TZ=False;DEFAULT_AUTO_FIELD 为 BigAutoField。
- 数据库配置含 ENGINE、NAME、HOST、PORT、USER、PASSWORD。
- 数据库账号密码用 os.environ.get 读取,不硬写配置文件;改环境变量后需重启项目。
- logger 封装:LOGGING 字典配 formatters、handlers、loggers。
- 第三方日志 loguru 配置更简单、效率更高;本项目先用内置 logging。
- 日志级别从低到高 DEBUG、INFO、WARNING、ERROR;console 建议 WARNING,file 建议 ERROR。
- console handler 输出控制台,file handler 用 RotatingFileHandler 按大小切割落文件。
- verbose 格式带时间与行号,simple 格式不带;propagate 控制是否向上冒泡。
- utils 中用 logging.getLogger('django') 建公共日志对象,视图导入后调用。
- 项目内禁用 print,统一用 logger.info / logger.error,靠日志级别控制输出。
- 自定义异常类继承 Exception,构造方法带 msg 与 detail,细粒度区分错误。
- 示例 PasswordError 带 msg 与 detail,捕获后通过 e.detail 取补充信息。
- 全局异常处理先记日志:用户、访问地址、请求方式、视图类、错误信息。
- res.data 可能是 dict 或 list:dict 取 detail 或整体消息,list 取第一条。
- 返回码:drf 异常 998,非 drf 异常兜底 997,系统错误 999。
- 处理器注册后视图可直接抛异常,前端始终收到固定结构返回。
- APIResponse 继承 Response,默认 code=100、msg='成功'、status=200。
- kwargs 不为空时全部展开进响应体;headers 写自定义响应头,status 传如 201 改 HTTP 状态码。
- 常见用法:APIResponse() 返回默认成功;APIResponse(token=..., username=...) 带登录字段。
- APIResponse(results=[...]) 带列表数据,APIResponse(result={}) 带单对象。
- 后台管理基于 admin 二次美化,选型 simpleui(element-ui + vue),xadmin 已不用。
关键代码
sys.path 注入与配置入口切换:
import os, sys
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))
sys.path.insert(0, str(BASE_DIR))
# manage.py:DJANGO_SETTINGS_MODULE = 'luffy_api.settings.dev'
# wsgi.py / asgi.py:DJANGO_SETTINGS_MODULE = 'luffy_api.settings.prod'
统一响应体骨架:
from rest_framework.response import Response
class APIResponse(Response):
def __init__(self, code=100, msg='成功', status=200, headers={}, **kwargs):
data = {'code': code, 'msg': msg}
if kwargs:
data.update(kwargs)
super().__init__(data=data, status=status, headers=headers)
踩坑
- No module named 'home':应用已注册但 apps 目录没进 sys.path,导入找不到;把 apps 目录 insert 到 sys.path。
- runserver 找不到配置文件:settings.py 移入 settings 包后入口路径未改;manage.py 改为指向 dev.py。
- 日志文件写不出来:logs 目录不会自动创建,RotatingFileHandler 只建文件;需手动建好日志文件夹。
- 注释内置应用后 drf 报错:auth、session 等被注释会牵连 drf;保留必要项或补 UNAUTHENTICATED_USER 配置。
二、用户与登录
扩写 auth 用户表并打通头像访问,实现多方式登录、短信验证码登录与注册,配套 CORS 跨域放行。
要点
用户表扩写
- User 继承 AbstractUser,复用 username、password、email 等 auth 字段。
- 扩写 mobile:CharField,max_length=11,unique。
- 扩写 icon:ImageField,upload_to='icon',default='icon/default.png'。
- 表名 db_table='luffy_user';配置 AUTH_USER_MODEL='user.User'。
- 必须在首次迁移前定好模型与配置;ImageField 依赖 pillow。
- 密码沿用 auth 加密:sha256 + SECRET_KEY + 盐;建号用 create_user。
media 访问
- MEDIA_URL='/media/',MEDIA_ROOT 指向项目下 media 目录,目录手动建。
- 总路由配 serve,把 /media/ 路径映射到 MEDIA_ROOT。
- static 存前端打包静态资源,media 存用户上传内容。
- 头像返回时用 MEDIA_URL 拼出完整访问地址。
登录方案与多方式登录
- 用 simplejwt 签发三段式 JWT:RefreshToken.for_user(user).access_token。
- 不依赖 session;前端从本地取 token,手动放进请求头。
- 登录成功返回 username、token、icon 三个字段。
- 多方式登录入参 {username, password},validate 内按正则分流。
- 手机号正则查 mobile,邮箱正则查 email,其余查 username。
- 用户存在且 check_password 通过才签发 token,失败抛 APIException。
- 异常由全局异常处理统一返回固定结构,不再用 ValidationError。
- 基类封装
_get_user、_get_token、_pre_data,子类只重写_get_user。 - 视图共用 login 方法,get_serializer_class 按 action 切序列化类。
- icon 是文件对象,需拼 BACKEND_URL + '/media/' + str(icon) 返回。
五个用户接口
| 接口 | 方式 | 入参 | 处理与出参 |
|---|---|---|---|
| 校验手机号 | GET | mobile | get 查到返回存在,否则抛异常 |
| 多方式登录 | POST | username, password | 校验密码后签发 JWT,返回 username/token/icon |
| 发送短信 | POST | mobile | 验证码存 cache,调 SDK 异步发送 |
| 短信登录 | POST | mobile, code | 比对验证码,用户存在签发 JWT |
| 注册 | POST | mobile, code, password | 校验验证码,create_user 建号 |
短信验证码与腾讯云 SDK
- 校验接口返回是否存在的标识,前端据此控制发码按钮。
- 校验用 get 查唯一记录,查不到或多条都由 except 兜底抛异常。
- 发送短信请求体只带 mobile;手机号可加密后再传,防止接口被刷。
- 验证码存 cache,key
sms_{mobile},过期 5 分钟;不存 session。 - 发送短信是耗时操作,用多线程异步发送,异步后无法立即得知成败。
- SDK 密钥 SecretId、SecretKey 建议放环境变量,不硬编码进代码。
- SmsSdkAppId、SignName、TemplateId 必须审核通过后才能下发。
- TemplateParamSet 个数与模板变量一致;手机号按 E.164 加 +86。
- 注册字段 code 不是表中字段,序列化类里要重写声明。
- 注册重写 create,非表字段先 pop,再 create_user 加密入库。
- 短信登录验证码失败抛"验证码错误",用户不存在抛"手机号不存在"。
- 注册成功提示去登录;也可注册成功直接签发 token 进入登录态。
- DEBUG 环境留 8888 验证码后门,上线前关闭 DEBUG。
前端登录状态
- 前端失焦先过正则
/^1[3-9][0-9]{9}$/,再调校验接口。 - 登录页手机号存在才允许发码;注册页不存在才允许发码。
- 登录成功把 token、username、icon 存 cookie,pinia 提供 set_user、log_out。
- 前端接口按模块封装到 user.js,页面只调用导出的请求方法。
CORS 跨域
- 成因是浏览器同源策略;项目用 CORS 放行,另可选 nginx 代理、node 代理。
- 简单请求:方法为 HEAD/GET/POST,且头信息不超出白名单,只发一次。
- 非简单请求:携带自定义头或非常规 Content-Type,先发 OPTIONS 预检。
- 预检放行后再发真实请求;自定义中间件 OPTIONS 时补 Allow-Headers、Allow-Methods。
- 第三方 django-cors-headers:app 加 corsheaders,中间件加 CorsMiddleware。
- 配置 CORS_ORIGIN_ALLOW_ALL、CORS_ALLOW_METHODS、CORS_ALLOW_HEADERS。
- CORS_ALLOW_HEADERS 需包含 authorization、content-type、token 等自定义头。
关键代码
多方式登录序列化判定骨架:
import re
from rest_framework.exceptions import APIException
def _get_user(self, attrs):
username = attrs.get('username')
password = attrs.get('password')
if re.match(r'^1[3-9][0-9]{9}$', username):
user = User.objects.filter(mobile=username).first()
elif re.match(r'^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$', username):
user = User.objects.filter(email=username).first()
else:
user = User.objects.filter(username=username).first()
if user and user.check_password(password):
return user
raise APIException(detail='用户名或密码错误')
短信验证码存缓存与注册建号:
from django.core.cache import cache
# 发送短信:验证码存缓存,5 分钟过期
cache.set(f'sms_{mobile}', code, 5 * 60)
# 注册:校验验证码后加密建号
class RegisterSerializer(serializers.ModelSerializer):
def create(self, validated_data):
return User.objects.create_user(**validated_data)
踩坑
- 迁移后再扩 User 字段:auth 表已生成,后续改字段牵连既有表;必须首次迁移前配好模型与 AUTH_USER_MODEL。
- ImageField 报错或上传失败:缺 pillow 依赖;先 pip install pillow 再执行迁移。
- media 目录或路由缺一:头像 404;MEDIA_ROOT 目录手动创建,总路由 serve 配齐。
- OPTIONS 预检未放行:非简单请求被浏览器拦截;中间件在 OPTIONS 补响应头,第三方方案 app 与中间件都要注册。
三、Redis 与 Celery
用 redis 做缓存、计数与队列,用 celery 把短信、秒杀、定时刷缓存等耗时操作挪到后台异步执行,缩短接口响应、提高 qps。
要点
Redis 连接方式
- 直连:
redis.Redis(host, port, db),每次实例化新建一条 TCP 连接。 - 连接池:先建
ConnectionPool全局复用,再传给Redis(connection_pool=...)。 - Web 高并发必须走池,直连会让 redis 连接数迅速暴涨。
- 连接参数加
decode_responses=True,返回 str 而不是 bytes。 - 选库用
db,有密码传password,多环境隔离靠 db 号区分。 - 通用键操作:
delete/exists/expire/keys/type,与类型无关。
五大数据类型
| 类型 | 典型命令 | 项目场景 |
|---|---|---|
| string | set / get / mset / mget / incr / setex | 验证码、计数器、普通缓存 |
| hash | hset / hget / hgetall / hkeys / hvals | 用户、商品等对象属性缓存 |
| list | lpush / rpush / lpop / rpop / lrange | 消息队列、最新排行 |
| set | sadd / srem / smembers / sinter / sismember | 去重、交集并集 |
| zset | zadd / zrange / zrevrange / zincrby | 排行榜、按分数排序 |
- string 支持
ex / px / nx / xx,计数用incr、浮点用incrbyfloat。 - hash 大对象用
hscan_iter分页遍历,避免一次性拉爆内存。 - list 阻塞取元素用
blpop / brpop,切片lrange、裁剪ltrim。 - set 天然去重,交集并集差集靠
sinter / sunion / sdiff。 - zset 每个成员带 score,排行与排序都基于这个分数。
Django 集成 redis
- 自建池:自己维护 pool,从池里取原生 redis 连接。
- django-redis:
CACHES配 backend 与LOCATION,get_redis_connection()取连接。 - 框架缓存:
cache.set()/cache.get(),底层 pickle 序列化后存 redis。 -
cache.set存的是 pickle 后的值,不能拿到别的客户端当原生 string 读。 - 缓存键按业务命名,避免不同接口的同名键互相覆盖。
- 配置项写在当前运行的 settings,层级与
INSTALLED_APPS平级。
Celery 架构与三种任务
- producer 是业务程序,broker 存任务队列,worker 多线程执行,backend 存结果。
- beat 是定时调度器,按时间表把任务投递到 broker,自身不执行任务。
- 异步任务:提交即返回,调用
任务.delay(参数)。 - 延迟任务:指定未来时刻执行,
apply_async(args=[], eta=时间对象)。 - 定时任务:beat 按
beat_schedule投递,配timedelta或crontab。 - celery 与 django 相互独立,可部署在多个节点上分担任务。
Django 接入要点
- 通用方案:把
celery_task包放进项目目录,worker 启动时指向该包。 - 通用方案要用 django 的表、缓存时,先设
DJANGO_SETTINGS_MODULE。 - 官方方案:根目录建
celery_main.py,autodiscover_tasks()扫各 app 的tasks.py。 -
config_from_object加载 settings 中CELERY_前缀的配置项。 - 任务统一用
@shared_task,不依赖具体 app 对象,注册导入更解耦。 - worker 与 beat 分两个控制台启动;Windows 下 worker 加
-P eventlet。
轮播图缓存与双写一致性
- 读流程:先查缓存,命中直接返回;未命中再查库,序列化后写回缓存。
- 数据库改了缓存没更新,就是双写不一致问题。
- 删缓存:写库后删缓存,下次读时回源重建,实现简单。
- 更新缓存:写库后直接刷新缓存,一致性好但写放大更明显。
- 定时更新:定时任务周期性刷新,适合轮播图这类实时性要求低的数据。
- 定时任务序列化图片地址不带域名,需在视图里拼
BACKEND_URL。
辅助组件与异步秒杀
- django-celery-beat:定时任务配置落库,admin 界面增删改,动态替换
beat_schedule。 - django-celery-results:结果存数据库而非 redis,admin 里直接看任务状态。
- flower 提供 Web 界面,查看 worker、broker 与任务进度和历史记录。
- 任务成功失败可走钩子发邮件或短信告警,不用人工一直盯界面。
- 同步秒杀全程阻塞等待扣减下单,并发高时接口排队严重。
- 异步方案先返回排队状态,后台慢慢处理,前端按 task_id 轮询结果。
关键代码
redis 连接池与 Django 缓存取用:
import redis
POOL = redis.ConnectionPool(host="127.0.0.1", port=6379, db=0, decode_responses=True)
conn = redis.Redis(connection_pool=POOL)
conn.set("banner_cache", data, ex=3600)
# 视图中走框架缓存
from django.core.cache import cache
res = cache.get("banner_cache")
if not res:
res = query_from_db()
cache.set("banner_cache", res)
celery 任务定义、提交与启动:
from celery import shared_task
@shared_task
def seckill(course_id):
# 后台扣减库存、生成订单
return True
# 业务中提交:seckill.delay(course_id)
# 启动:celery -A <项目名> worker -l info -P eventlet
# 定时:celery -A <项目名> beat -l debug
踩坑
- 直连导致连接数暴涨:每次请求新建 TCP 连接,高并发下连接吃满;改用全局连接池复用。
-
连接池未真正复用:函数内反复新建
ConnectionPool,池对象被丢弃;池放到模块级只建一次。 -
bytes 未解码:redis-py 默认返回 bytes,直接当 str 用会报错;连接时加
decode_responses=True。 - worker 与 beat 混淆:只起 worker 不跑定时任务,或把 beat 当执行单元;两者分进程启动,beat 只投递、worker 才执行。
四、课程与视频
把课程模块从库表关联打通到列表、详情接口与前端联调,并明确视频、文档等文件的托管选型与接入方式。
要点
课程板块表五层关联
- 分类 → 实战课程 → 章节 → 课时逐层包含,老师被课程表外键引用。
- 分类负责分组(实战 / 免费 / 轻课),老师存授课信息,课程主表存价格与学生数。
- 章节挂在课程下,课时挂在章节下,形成完整课程树。
- 外键参数:
on_delete删父级行为,db_constraint=False关库级约束,related_name反查名。
课程列表接口
- 序列化内嵌老师子序列化;choice 字段经模型
@property返回中文名。 -
section_list在模型层定制:总课时大于 4 条只返 4 条,不足 4 条全返。 - 视图先过滤
is_delete=False, is_show=True,再按orders排序。 - 排序用
OrderingFilter,允许price、students;过滤用DjangoFilterBackend按course_category。 - 分页 mixin 区分有 / 无分页:有分页包
count / next / previous / results,无分页直接返results。 - 分页类参数:
page_size默认条数,page_query_param页码名,page_size_query_param单页条数名,max_page_size封顶。
课程详情接口
- 思路一:两个接口。详情复用列表序列化类,再按课程 id 单独查章节,前端两次请求拼装。
- 思路二:一个接口。重写
get_serializer_class,retrieve时换详情序列化类,章节嵌套课时一次返回。
前端联调
- 列表页用
reactive管理分类、排序、页码、每页条数,监听变化重新拉取。 - 排序字段带正负号切换升降序;分类大于 0 才把
course_category带进查询。 - 详情页从路由参数取课程 id,id 小于 1 时提示并返回;播放器用 video.js 封装。
视频托管
- 免费视频走第三方(七牛云、阿里 OSS、腾讯云)或自建;收费视频常用保利威。
- 直接放项目 media 文件夹不适合生产;自建方案有 FastDFS、ceph、MinIO。
- FastDFS:
22122供 SDK 上传、删除,8888供 web 访问。 - MinIO:
9000供代码上传与文件访问,9090为 web 管理控制台。 - 自建分布式存储由运维用 docker 维护,开发只按 SDK 上传、删除并取访问地址。
关键代码
列表视图:过滤、排序、分页一次配齐:
from rest_framework.filters import OrderingFilter, DjangoFilterBackend
class CourseView(GenericViewSet, CommonListModelMixin):
queryset = Course.objects.all().filter(is_delete=False, is_show=True).order_by('orders')
serializer_class = CourseSerializer
filter_backends = [OrderingFilter, DjangoFilterBackend]
ordering_fields = ['price', 'students']
filterset_fields = ['course_category']
pagination_class = CommonPageNumberPagination
详情接口按 action 切换序列化类:
def get_serializer_class(self):
if self.action == 'retrieve':
return CourseDetailSerializer
return CourseSerializer
踩坑
-
分页参数越界:前端传过大
page_size会拖垮列表查询;分页类必须设max_page_size封顶。 -
详情序列化类切换出错:详情复用列表类导致章节课时缺失;
retrieve时换详情序列化类,章节再嵌套课时。 - 视频上传配置错:FastDFS、MinIO 端口与 SDK 配错会上传失败或地址打不开;按端口分工核对 tracker 配置与 endpoint。
五、支付宝支付
打通课程购买闭环:下单生成支付链接,同步跳转只做页面判断,异步回调验签后修改订单状态。
要点
沙箱环境与网关
- 无营业执照先用沙箱环境测试,正式上线再换企业商户号。
- 沙箱网关
openapi-sandbox.dl.alipaydev.com/gateway.do,正式网关openapi.alipay.com/gateway.do。 - 网关由
DEBUG开关切换,配置集中在支付包的 settings 中。 - 通信与验签走非对称加密 RSA2:应用私钥留着签名,支付宝公钥验签回传消息。
下单生成支付链接
- 下单接口需登录,配
JWTAuthentication与IsAuthenticated。 - 前端点购买,携带课程 id、总价、支付方式请求下单接口。
- 序列化类校验前端总价与课程累加价一致,不一致抛异常。
- 价格传数值不传字符串;用
uuid生成全局唯一out_trade_no,再取当前登录用户。 - 调 SDK
api_alipay_trade_page_pay生成订单串,拼网关得到支付链接返给前端。 - 前端拿到
pay_url后当前页打开跳转支付宝收银台。 - 落库两张表:订单表
Order存主信息,订单详情表OrderDetail存课程明细,一个订单对应多条详情。
同步 get 回调
- 付款后支付宝跳回前端页面,只做展示与判断,不改订单状态。
- 前端解析 url 查询参数,展示订单号、交易号、付款时间,注意 url 解码。
- 前端带订单号请求后端
check_order:查到order_status=1即已支付,否则提示稍后刷新。
异步 post 回调
- 支付宝主动 POST 到 notify_url,该接口不加登录认证与权限类。
- 回调编码是 urlencoded,先
request.data.dict()转成纯字典,再pop出sign。 - 调 SDK
verify验签;通过且trade_status为TRADE_SUCCESS或TRADE_FINISHED才改单。 - 更新订单状态、支付宝流水号
trade_no、支付时间pay_time。 - 按固定格式返回
success,未通过返回failed;支付宝 24 小时内最多回调 8 次。
订单状态流转
| 状态码 | 含义 | 触发时机 |
|---|---|---|
| 0 | 未支付 | 下单默认 |
| 1 | 已支付 | post 回调验签成功 |
| 2 | 已取消 | 用户主动取消 |
| 3 | 超时取消 | 超时未支付 |
al_pay 包结构
-
libs/al_pay/:pay.py建AliPay客户端,settings.py读密钥与网关,pem/放应用私钥与支付宝公钥。
关键代码
post 回调验签并修改订单状态:
@action(methods=['POST'], detail=False)
def check_al_order(self, request, *args, **kwargs):
data = request.data.dict()
out_trade_no = data.get('out_trade_no')
trade_no = data.get('trade_no')
sign = data.pop('sign')
if alipay.verify(data, sign) and data['trade_status'] in ('TRADE_SUCCESS', 'TRADE_FINISHED'):
Order.objects.filter(out_trade_no=out_trade_no).update(order_status=1, trade_no=trade_no)
return Response('success')
return Response('failed')
下单时生成支付链接:
pay_url = alipay.api_alipay_trade_page_pay(
out_trade_no=out_trade_no, total_amount=float(total_amount),
subject=subject, return_url=settings.RETURN_URL, notify_url=settings.NOTIFY_URL)
self.context['pay_url'] = GATEWAY + pay_url
踩坑
- 支付宝回调打不到本地:内网无公网 IP,post 回调收不到;用内网穿透暴露本地端口,上线后配公网 notify_url。
- 验签失败:误用自己的应用公钥验签,或证书缺头尾;必须用支付宝公钥验签回传消息。
-
沙箱网关配错:沙箱与正式网关混用会导致下单或签名失败;按
DEBUG切换对应网关地址。 -
订单状态被重复修改:回调可能多次到达;按
out_trade_no幂等更新,已支付订单不再重复处理。
六、部署与协作
多人借远程仓库并行开发并解决冲突,最终把前端静态资源与后端服务部署到云服务器,由 nginx 统一对外。
要点
Git 协作与分支
- 分支模型:master 为主分支,dev 为开发分支,bug 分支修缺陷;小版本修 bug,大版本加功能。
- 协同流程:仓库拥有者把对方加为开发者,对方 clone 后配环境、装依赖,再 add、commit、push。
- 冲突产生:多人同一分支改同一文件同一行,或本地分支合并时改到同一处。
- 冲突标记:pull 后出现 HEAD、=======、commit 号三段标记,手动取舍后再提交。
- 避免冲突:动手前勤 pull,保持本地版本库与远端一致。
- fetch 与 pull:pull = fetch + merge;fetch 只拉远端更新到本地,不自动合并。
- rebase:变基合并用于整理提交历史,会改写提交记录;已推送的提交不要 rebase。
- git flow:一套按 master、dev、bug 分工的分支工作流。
- 合并请求:GitHub/Gitee 称 PR,GitLab 称 MR;选清源分支并入目标分支,管理员同意后合并。
- 图形化:pycharm、sourcetree 可完成 add、commit、pull、push 与分支管理;公司内部多用 GitLab 私服。
- 开源贡献:先 fork 到自己仓库,clone 修改后提交,再提 PR 等待对方管理员合并。
部署上线
- 服务器:购买云服务器(centos 7.9)并分配公网 ip;域名需工信部备案,用 finalshell 远程连接。
- 域名解析:购买域名后配置解析,把域名指向服务器公网 ip,外部即可按域名访问。
- 环境准备:服务器装 git、mysql;后端导出 requirements.txt,clone 后在虚拟环境装依赖,建库、建用户并授权。
- 前端打包:npm run build 生成 dist,只把 dist 上传服务器,交 nginx 代理静态资源。
- 后端配置:pro.py 配前后端基地址,迁移表后由 uwsgi 运行 wsgi.py;上线再启动 celery worker 与 beat。
- 静态收集:uwsgi 只处理动态请求,静态资源交 nginx;pro.py 配 STATIC_ROOT,执行 collectstatic 统一收集。
- nginx 反代:前端 dist 由 root 静态代理并 try_files 回退 index.html;后端 location 经 uwsgi_pass 转发,/static 用 alias 指向收集目录。
- 守护进程:uwsgi 用 xml 配置 socket、chdir、module、processes 与 daemonize 日志,启动后查进程、pkill 关闭。
- 端口放行:安全组开放 22、80、8000、3306、6379、8888;出问题按 nginx、uwsgi、项目三层日志排查。
关键代码
协作与分支常用命令:
git clone <仓库地址>
git pull origin master # 先拉最新,等价 fetch + merge
git checkout dev # 切到开发分支
git add . && git commit -m '功能提交'
git push origin dev
git checkout master && git merge dev
uwsgi 守护进程配置骨架:
<uwsgi>
<socket>127.0.0.1:8888</socket>
<chdir>/<项目目录>/</chdir>
<module>项目.wsgi</module>
<processes>4</processes>
<daemonize>uwsgi.log</daemonize>
</uwsgi>
踩坑
- 冲突标记未清就提交:<<<<<<<、=======、>>>>>>> 残留在文件里导致页面或接口异常;先手动删标记、定保留内容,再 add、commit、push。
- 本地不是最新就 push:远端已有他人提交时推送被拒;先 pull 合并,解决冲突后再推。
- ssh 公钥未配好:push 仍要账号密码或被拒;把公钥配到平台账户,remote 地址改成 ssh 形式。
- 忽略名单漏依赖目录:node_modules、venv、*.pyc、db.sqlite3 被提交进仓库;补 .gitignore,已跟踪文件先移除再提交。
需背的基础(压缩版)
- Vue 指令:插值 {{ }}、v-if/v-show、v-for 带 key、v-model 双向绑定。
- 生命周期:组件挂载、更新、销毁阶段挂副作用与清理。
- vuex:集中管理跨组件共享状态;router 管路由跳转与守卫。
- git 入门:init 初始化、status 看状态、add 入暂存、commit 入库、log 查日志。