VSCode Conda环境安装TensorFlow后仍遇ModuleNotFoundError问题求助

问题描述 #

在Windows 10系统中，通过Anaconda终端创建名为deeplearning的Conda环境，安装TensorFlow、Jupyter、Pandas等依赖包后，经Anaconda导航器确认安装完成。在VSCode中选定该环境的Python解释器，但执行import tensorflow as tf时触发ModuleNotFoundError，Matplotlib等包可正常导入，重启电脑、重建环境均无效。

排查与解决步骤 #

1. 验证环境中TensorFlow的实际安装状态 #

打开Anaconda终端，激活目标环境后执行检查命令：

activate deeplearning
# 用Conda命令检查
conda list tensorflow
# 或用pip检查
pip list | findstr tensorflow

若输出无TensorFlow或版本异常，重新执行安装命令：

conda install -c conda-forge tensorflow tensorflow-datasets

注意：避免Conda与pip混合安装包，优先用Conda统一管理环境依赖。

2. 绑定Conda环境到Jupyter内核 #

VSCode笔记本可能使用错误内核，即使选定解释器也不生效：

• 打开VSCode命令面板（Ctrl+Shift+P），输入Jupyter: Select Kernel，选择Python 3.7.16 ('deeplearning')内核
• 若无对应选项，手动注册内核：
  1. 激活deeplearning环境，安装ipykernel：

     conda install -c anaconda ipykernel
     

  2. 注册环境为Jupyter内核：

     python -m ipykernel install --user --name deeplearning --display-name "Python (deeplearning)"
     

  3. 重启VSCode后重新选择内核

3. 确认VSCode的Python解释器路径准确性 #

手动验证并指定解释器路径：

• 激活deeplearning环境，执行命令获取完整路径：

  where python
  

• 在VSCode命令面板选择Python: Select Interpreter，点击Enter interpreter path，粘贴上述命令输出的完整路径（如C:\Users\你的用户名\anaconda3\envs\deeplearning\python.exe）并确认

4. 清理VSCode缓存并重启 #

缓存异常可能导致环境识别错误：

• 关闭VSCode，删除以下目录的缓存文件：
  • %APPDATA%\Code\Cache
  • %APPDATA%\Code\CachedData
• 重新打开VSCode，重新选择解释器与内核

5. 避免全局Python与Conda环境冲突 #

检查VSCode默认解释器设置：

• 打开VSCode设置（Ctrl+,），搜索python.defaultInterpreterPath，设置为deeplearning环境的Python完整路径

内容的提问来源于stack exchange，提问作者Some Freaking Cactus