为何导入TensorFlow时出现‘ImportError: cannot import name 'float8_e4m3fn'’错误？

• 版本不匹配（最常见诱因）
  float8_e4m3fn是TensorFlow 2.14及以上版本才正式纳入的dtype类型。之前能正常运行现在报错，大概率是虚拟环境里的TensorFlow被意外降级到2.14以下，或是依赖的TFOD相关库、Keras等要求更高版本的TF，但当前本地TF版本未达标。
  解决步骤：

  1. 先检查当前TF版本：

     python -c "import tensorflow as tf; print(tf.__version__)"
     

  2. 若版本低于2.14，直接升级到兼容版本：

     pip install --upgrade tensorflow>=2.14
     

  3. 要是升级后出现依赖冲突，建议重建虚拟环境并指定匹配版本：

     # 卸载现有TF
     pip uninstall tensorflow -y
     # 安装指定版本（示例为2.14.0，可根据TFOD官方要求调整）
     pip install tensorflow==2.14.0
     # 重新安装TFOD API
     pip install --upgrade tensorflow-object-detection-api
     

• 依赖库版本冲突
  比如安装的keras、tf-models-official等库版本过高，调用了高版本TF的API但本地TF版本未跟进；或是TF版本过高，依赖库尚未适配。
  解决步骤：

  1. 查看当前TF相关依赖版本：

     # Windows
     pip list | findstr tensorflow
     # Linux/macOS
     pip list | grep tensorflow
     

  2. 确保所有TF衍生依赖版本和TF主版本兼容（比如TF 2.14对应Keras 2.14.x），必要时重新安装匹配版本：

     pip install keras==2.14.0 tensorflow-object-detection-api==0.12.0
     

• 虚拟环境文件损坏
  虚拟环境内的包文件可能因误删、磁盘错误等损坏，导致导入异常。
  解决步骤：

  1. 先导出当前环境依赖清单：

     pip freeze > requirements.txt
     

  2. 删除旧虚拟环境，重建并重装依赖：

     # Windows 删除环境
     rmdir /s tfod
     # Linux/macOS 删除环境
     rm -rf tfod
     # 重新创建虚拟环境
     python -m venv tfod
     # 激活环境（Windows）
     tfod\Scripts\activate
     # 激活环境（Linux/macOS）
     source tfod/bin/activate
     # 安装依赖
     pip install -r requirements.txt
     

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