为何Django文档始终使用HttpRequest类型而非实际的WSGIRequest？

• 抽象接口的统一表达：HttpRequest是Django定义的请求基类，是所有请求实现的抽象接口，它规定了视图开发中需要用到的核心属性与方法（比如GET、POST、user等）。不管是WSGI环境下的WSGIRequest，还是ASGI环境的ASGIRequest，甚至是测试用例里生成的模拟请求，都继承并实现了这个基类的接口。文档用基类描述，是为了让开发者聚焦于通用的请求操作，无需关心底层具体的请求实现类。

• 兼容多协议的设计预留：Django早期以WSGI为主要部署方式，但框架从设计阶段就保留了抽象层。后来ASGI协议加入时，只需要新增ASGIRequest继承自HttpRequest即可，文档和开发者的使用习惯无需大规模调整。这种设计让框架能灵活适配不同的网络协议，而文档保持基类表述正是这种兼容性的体现。

• 降低学习与认知成本：对绝大多数开发者来说，不需要区分WSGIRequest和ASGIRequest，只要掌握HttpRequest提供的通用能力就能完成开发。文档使用基类可以避免引入不必要的底层细节，让新手更快聚焦于业务开发本身。

• 类型注解的通用性：在类型提示中，用HttpRequest作为类型注解比具体的WSGIRequest更通用——不管部署环境是WSGI还是ASGI，注解都能生效，同时也契合面向接口编程的思想。

内容的提问来源于stack exchange，提问作者fishfin