Python中如何结合类型提示使用Flask，解决Pylance route装饰器类型报错

Flask 2.x及更早版本没有内置完整的类型标注，Pylance底层的Pyright类型检查器无法识别route装饰器的完整类型签名，因此会抛出部分类型未知、无类型装饰器的两类错误。

• 方案1：安装官方维护的Flask类型stub包
  执行命令pip install flask-stubs，安装完成后重启VSCode的Pylance服务即可，该方案适配Flask 2.0及以上的旧版本。
• 方案2：升级到内置类型标注的Flask版本
  Flask从2.3版本开始已经内置了官方维护的完整类型签名，不需要额外安装stub包，执行命令pip install -U flask升级到最新稳定版即可解决报错。
• 临时屏蔽方案（不推荐长期使用）
  如果暂时不想修改项目依赖，可以在报错的装饰器行上方添加注释# type: ignore直接屏蔽该行的类型检查，或者在项目根目录的pyrightconfig.json中配置全局忽略规则，该方案治标不治本，仅适合临时调试使用。

• 优先选择带内置类型标注的依赖版本
  开发时优先使用Flask ≥2.3、Werkzeug ≥2.3版本，这两个核心依赖从2.3版本开始都内置了官方维护的类型签名，兼容性和准确性远高于第三方stub包。
• 补齐生态组件的类型标注
  如果用到Flask扩展（如Flask-SQLAlchemy、Flask-Login等），优先选择带内置类型的版本，没有内置类型的扩展可安装对应types命名空间下的stub包，例如pip install types-flask-sqlalchemy、pip install types-flask-login。
• 给视图函数添加完整类型标注
  不要保留无类型签名的视图函数，明确标注入参和返回值类型可以大幅降低Pylance的类型识别误差，示例代码优化如下：

  from flask import Flask
  from dotenv import load_dotenv
  
  load_dotenv()
  
  app = Flask(__name__)
  
  
  @app.route('/')
  def hello_world() -> str:
      return '<h1>Hello world</h1>'
  

• 合理配置Pylance的检查规则
  在项目的pyrightconfig.json或者VSCode的settings.json中调整类型检查的严格度，不需要报错的规则可以调整为警告级别，示例配置如下：

  {
    "python.analysis.typeCheckingMode": "basic",
    "python.analysis.diagnosticSeverityOverrides": {
      "reportUntypedFunctionDecorator": "warning",
      "reportUnknownMemberType": "warning"
    }
  }
  

• 自定义装饰器补充类型签名
  如果你自己开发Flask装饰器或者扩展，需要使用typing.Callable或者@typing.overload明确标注装饰器的入参、出参类型，避免装饰器遮挡被修饰函数的类型信息。

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