VSCode中Pylance提示tensorflow.keras导入无法解析的问题求助

问题场景 #

代码可正常运行，但Pylance持续提示错误：

Import "tensorflow.keras" could not be resolved

使用的导入代码：

import tensorflow.keras as keras

已尝试添加extraPaths（路径取自keras.__file__输出）、重启程序，但问题未解决。

可行解决方案 #

• 确认VSCode使用的Python解释器正确
  左下角状态栏显示的Python版本必须是安装了TensorFlow/Keras的环境。若不确定，打开命令面板（Ctrl+Shift+P）执行Python: Select Interpreter，选择对应解释器（系统Python 3.11或目标虚拟环境）。

• 调整python.analysis.extraPaths路径
  当前添加的路径层级过深，Pylance需要的是能找到tensorflow或keras顶层模块的根路径。修改.vscode/settings.json为：

  {
      "python.analysis.extraPaths": [
          "/usr/lib/python3.11/site-packages"
      ]
  }
  

  该路径是Python第三方包的根目录，可覆盖所有库的导入识别需求。

• 改用直接导入Keras
  在TensorFlow 2.x版本中，tensorflow.keras与独立keras包功能等价，直接替换导入语句：

  import keras
  

  此方式能让Pylance直接识别独立Keras库的结构，避免别名导入的解析问题。

• 重启Pylance语言服务
  打开命令面板执行Python: Restart Language Server，强制清除Pylance缓存，重新加载库的结构信息。

• 启用Pylance库代码类型推断
  在.vscode/settings.json中添加或确保以下设置：

  {
      "python.analysis.useLibraryCodeForTypes": true
  }
  

  该设置让Pylance直接读取库的源代码推断类型，提升导入识别的准确性。

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