django知识体系梳理

。

章节 回答的问题 关键产出
一、环境与项目骨架 一个能长期维护的 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 查日志。
最后编辑于 :
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

友情链接更多精彩内容