Sublime Text 搭建 DRF 项目关键在于理解序列化器与视图集机制:Serializer 是数据“翻译官”,负责验证、转换与嵌套;ViewSet 是接口“控制器”,统一管理 CRUD 行为;配合插件可提升效率,但核心是规范编码与清晰意图。

用 Sublime Text 搭建 Django REST Framework(DRF)项目,关键不在编辑器本身,而在对 DRF 核心机制的理解和规范编码。Sublime 轻量高效,配合插件(如 Anaconda、Djaneiro、BracketHighlighter)可胜任开发,但序列化器(Serializer)与视图集(ViewSet)的正确使用,才是 API 稳定、可维护的核心。
序列化器:数据进出的“翻译官”
Serializer 不是简单地把模型转成 JSON,它承担验证、转换、嵌套、权限控制前的数据预处理职责。定义时需明确目的——是用于读取(read_only=True)、创建(write_only=True),还是双向流通。
- 继承 serializers.ModelSerializer,通过 Meta 类指定模型和字段,避免手写大量字段声明
- 用 fields = '__all__' 快速起步,上线前务必改为显式列表(如 ['id', 'title', 'author']),防止意外暴露敏感字段
- 外键字段默认只显示 ID,加 depth = 1 可自动嵌套一层,但仅限简单场景;复杂关联推荐用 SerializerMethodField 或自定义子序列化器
- 在 create() 和 update() 方法中手动处理关联逻辑(如多对多、反向关系),DRF 不会自动保存嵌套对象
视图集:统一接口行为的“控制器”
ViewSet 把 list、retrieve、create、update、destroy 封装进一个类,配合 Router 自动生成 URL,大幅减少重复路由配置。但它不是万能模板——该拆分时就拆分,别硬塞所有逻辑进一个 ViewSet。
- 优先继承 viewsets.ModelViewSet,它已包含全部五个基础动作;若只需部分功能(如只读),改用 ReadOnlyModelViewSet 或组合 mixins
- 用 queryset 属性定义基础查询集(如 Post.objects.select_related('author')),而非在每个方法里重复写 .all()
- 重写 get_queryset() 实现动态过滤(如按登录用户、状态、时间范围),比在 serializer 中做更高效、更安全
- 权限与分页在 ViewSet 类属性中统一设置(permission_classes = [IsAuthenticated],pagination_class = PageNumberPagination),避免分散在各 action 中
Sublime 实用技巧:提升 DRF 编码效率
Sublime 本身不提供 Django 支持,但合理配置后可显著加快开发节奏:
- 安装 Djaneiro 插件,输入 drf_serializer 或 drf_viewset 可快速生成标准代码片段
- 用 Ctrl+Shift+P → “Set Syntax: Django HTML” 切换模板语法高亮,避免 {% %} 和 {{ }} 显示异常
- 将 manage.py 添加到 Sublime 工程根目录,右键菜单即可运行 runserver、makemigrations 等命令(需配置 Build System)
- 开启 Auto Save(菜单 → File → Auto Save),配合 Django 的热重载,改完保存即刷新 API 响应
基本上就这些。Sublime 是工具,DRF 是框架,真正决定项目质量的,是你对序列化流程边界的把握、对视图集职责的清醒认知,以及每一行代码背后的意图是否清晰。不复杂,但容易忽略。










