安装TensorFlow后报错ModuleNotFoundError: No module named 'tensorflow.python.eager'如何解决？

核心原因 #

该报错一般由TensorFlow安装不完整、环境路径不匹配、新旧版本文件残留或者本地文件命名冲突导致。

可执行解决步骤 #

• 先确认运行环境和安装路径匹配
  很多时候出现该问题是因为TensorFlow安装在了其他Python环境，当前运行代码的环境没有正确安装。执行以下命令验证：
  1. 打印当前运行代码的Python解释器路径：在你的代码头部加入import sys; print(sys.executable)运行即可得到
  2. 查看TensorFlow安装路径：执行pip show tensorflow，对比输出的Location字段是否和第一步得到的解释器路径下的site-packages目录匹配
     如果不匹配，切换到对应Python环境重新安装TensorFlow即可。
• 完全卸载残留后重装TensorFlow
  升级操作没有清理旧版本残留文件会导致模块索引异常，执行以下命令重装：

  # 卸载所有相关包
  pip uninstall -y tensorflow tensorflow-gpu tensorflow-estimator keras
  # 清理pip缓存
  pip cache purge
  # 安装稳定适配版本，这里以适配性较好的2.15.0版本为例
  pip install tensorflow==2.15.0
  

• 排查本地命名冲突
  检查你的代码文件、项目根目录下有没有命名为tensorflow.py的文件或者名为tensorflow的文件夹，这类命名会被Python优先导入，覆盖官方安装的TensorFlow库，改名后再运行即可。
• 版本适配校验
  确认当前Python版本和TensorFlow版本适配：
  • TensorFlow 2.10~2.15 支持Python 3.8~3.11
  • TensorFlow 2.16+ 支持Python 3.9~3.12
    如果Python版本超出适配范围，更换对应版本后再安装TensorFlow。

内容的提问来源于stack exchange，提问作者Zrn-dev