VSCode无法导入tensorflow.keras及检测不到TensorFlow库问题求助

问题现象 #

在VSCode中尝试导入tensorflow.keras时，编辑器无法检测到TensorFlow库，报错提示找不到该库。已尝试通过pip、conda多次卸载重装，均未解决问题。

实用解决步骤 #

• 确认VSCode使用的Python环境

  1. 查看VSCode左下角状态栏，点击当前显示的Python环境名称（比如Python 3.9.6 64-bit）。
  2. 在弹出的环境列表中，选择你安装了TensorFlow的目标环境（conda虚拟环境或pip全局环境均可）。
  3. 若不确定哪个环境装有TensorFlow，可打开终端执行命令核对：

     # pip环境查询TensorFlow
     pip list | grep tensorflow
     # conda环境查询TensorFlow
     conda list | grep tensorflow
     

• 检查导入语句是否正确
  TensorFlow 2.x版本后，keras已整合到tensorflow包内，请勿使用单独的import keras，正确导入写法为：

  from tensorflow import keras
  # 或者
  import tensorflow as tf
  tf.keras.models.Sequential()
  

• 重新安装TensorFlow到对应环境
  确认环境匹配但仍无法检测到库时，在VSCode终端切换到目标环境后执行重装：

  # pip指定稳定版本安装（示例为2.15.0）
  pip install tensorflow==2.15.0
  # conda指定稳定版本安装
  conda install tensorflow==2.15.0
  

• 清除VSCode缓存

  1. 关闭VSCode，删除对应路径的缓存文件夹：
     • Windows：%APPDATA%\Code\Cache 和 %APPDATA%\Code\CachedData
     • macOS：~/Library/Caches/Code 和 ~/Library/Application Support/Code/CachedData
     • Linux：~/.cache/Code 和 ~/.config/Code/CachedData
  2. 重新打开VSCode后再次尝试导入。

• 手动指定Python解释器路径

  1. 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板。
  2. 输入Python: Select Interpreter，选择正确的环境；若环境未显示，选择Enter interpreter path手动输入Python解释器的绝对路径（比如conda环境下的~/miniconda3/envs/tf_env/bin/python）。

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