VSCode下Keras的Intellisense智能提示链式调用场景工作异常

该异常本质是Pylance语言服务器对Keras动态生成的返回值类型推断失败导致的：导入阶段静态类型标注完整，所以提示正常；链式调用时方法返回值的类型多为运行时动态生成，默认配置下Pylance没有足够的类型信息做推断，所以提示不符合预期。

• 调整Pylance基础配置
  打开VSCode设置（快捷键Ctrl+,/Windows/Linux，Cmd+,/Mac），修改以下配置项：
  • 将Python > Analysis: Type Checking Mode设置为basic或strict，不要关闭类型检查
  • 开启Python > Analysis: Auto Import Completions
  • 开启Python > Analysis: Indexing，确保全库类型索引完整
• 安装补充类型桩文件
  终端执行以下命令安装Keras、TensorFlow对应的类型标注补充包，弥补官方包自带标注不全的问题：

  pip install keras-stubs tensorflow-stubs tensorflow-types
  

• 添加显式类型标注
  对链式调用的返回对象手动标注类型，强制Pylance识别对象类型，示例如下：

  from keras import Model
  from keras.layers import Input, Dense
  
  # 显式标注model的类型为Model
  model: Model = Input(shape=(10,))
  model = Dense(32)(model)
  # 后续调用model的方法时即可获得正常的智能提示
  

• 调整导入方式
  避免使用通配符导入、别名简写导入，优先使用全路径显式导入，避免Pylance识别错库路径，示例：
  优先用from tensorflow.keras.models import Sequential，不要用from keras import *或import tensorflow.keras as keras的简写形式
• 重置语言服务器缓存
  按Ctrl+Shift+P/MacCmd+Shift+P调出命令面板，执行Python: Restart Language Server，等待索引重建完成后验证提示是否正常。

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