Mac系统安装TensorFlow 2.9版本失败如何解决

问题复现 #

• 导入TF-Agent相关模块时抛出依赖错误：

ImportError: This version of TensorFlow Probability requires TensorFlow version >= 2.9; Detected an installation of version 2.6.3. Please upgrade TensorFlow to proceed.

• 执行pip install tensorflow --upgrade无升级效果，返回当前已安装版本为2.6.5：

Requirement already satisfied: tensorflow in ./opt/anaconda3/lib/python3.9/site-packages (2.6.5)

• 尝试安装tensorflow-macos时报错无匹配安装包：

ERROR: Could not find a version that satisfies the requirement tensorflow-macos (from versions: none) ERROR: No matching distribution found for tensorflow-macos

• 指定版本执行pip install 'tensorflow==2.9' --upgrade安装失败，pip可检索到的TensorFlow最高版本仅为2.7.3：

ERROR: Could not find a version that satisfies the requirement tensorflow==2.9 (from versions: 2.5.0, 2.5.1, 2.5.3, 2.6.0rc0, 2.6.0rc1, 2.6.0rc2, 2.6.0, 2.6.2, 2.6.3, 2.6.4, 2.6.5, 2.7.0rc0, 2.7.0rc1, 2.7.0, 2.7.1, 2.7.2, 2.7.3) 
ERROR: No matching distribution found for tensorflow==2.9

• 分别在Mac系统终端（使用python -m pip格式执行命令）、VS Code终端重复上述操作，均无法安装符合依赖要求的TensorFlow版本。

解决方案 #

根因 #

1. 本地pip版本过旧，配置的PyPI镜像源同步不全，未收录高版本TensorFlow安装包
2. Apple Silicon（M1/M2系列）芯片的Mac设备无法安装通用x86架构的TensorFlow 2.8及以上版本，需安装苹果官方适配的专属安装包
3. TensorFlow、TensorFlow Probability、TF-Agent三者有严格的版本对应关系，版本错配会持续触发导入报错

操作步骤 #

1. 先清理本地残留的旧版本相关包，避免版本冲突：

pip uninstall -y tensorflow tensorflow-macos tensorflow-probability tf-agents

2. 升级pip到最新版本，解决旧版pip无法识别新包格式的问题：

python -m pip install --upgrade pip

3. 按设备芯片类型选择对应安装命令：
   • Intel芯片Mac：Intel架构Mac最后一个原生稳定支持的TensorFlow版本为2.10，满足>=2.9的依赖要求，直接执行以下命令安装匹配版本的全套组件：

   pip install tensorflow==2.10 tensorflow-probability==0.18.0 tf-agents==0.15.0
   

   • Apple Silicon（M1/M2系列）芯片Mac：先确认本地Python版本在3.8~3.10区间（3.11及以上版本无对应2.9版本适配包），再执行以下命令：

   # conda环境先安装苹果官方依赖
   conda install -c apple tensorflow-deps -y
   # 安装适配版TensorFlow及匹配依赖
   pip install tensorflow-macos==2.9 tensorflow-metal==0.5.0 tensorflow-probability==0.17.0 tf-agents==0.13.0
   

4. 安装完成后执行版本校验，确认依赖正常：

import tensorflow as tf
import tensorflow_probability as tfp
import tf_agents
print(tf.__version__)  # 输出2.9及以上即为正常

注意事项 #

• 不要直接用conda install tensorflow安装，conda源的TensorFlow版本更新普遍滞后，大概率装到低版本包
• 若安装时仍提示找不到包，切换到官方PyPI源重试即可，不要用同步不全的老旧第三方镜像源

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