SuperAPI AI 工具集

django-conventions

通用与其它

查看项目

更新于 10-15 20:13

技能介绍

用途:该技能汇总 Django 最佳实践与约定,帮助构建高质量、安全、高性能的 Django 应用,可作为代码审查时的参考标准,也适用于设计应用与模型、编写视图/序列化器/表单、评估安全与性能、重构代码库以及向团队成员讲解规范。资料提到它设计为供 uncle-duke-python 智能体在 Django 代码审查中引用。

主要能力:强调约定优于配置、DRY、显式优于隐式、默认安全、数据库效率与可维护性。内容涵盖项目结构(项目配置与 apps 分离、按环境拆分 settings、RESTful URL 与 include())、模型(字段选择、Meta 选项、自定义管理器、QuerySet、迁移、索引与约束)、视图(CBV 与 FBV 对比)等。

必要用法与结构:推荐目录包含 manage.py、项目配置包(settings 拆分为 base/development/production/test)、apps/、static/、media/、templates/、requirements/ 与 README。应用按单一领域划分,模型类应用复数名词,工具类应用用单数。settings 通过 from .base import * 按环境继承,敏感信息用环境变量。URL 使用小写连字符、API 版本化、资源用复数名词并命名以便反向解析。模型使用 TextChoices/IntegerChoices、gettext_lazy、时间戳字段、合适的 on_delete、related_name、索引与约束,并重写 str。

适用场景:Django 项目代码审查、应用与模型设计、视图/序列化器/表单编写、安全与性能评估、代码库重构、团队教学。

限制:资料要求 Django 3.2+(建议 LTS)、Python 3.8+,生产建议 PostgreSQL;未提供安装命令、收费、价格或平台信息。