Anaconda环境导入DeepLabCut报错：找不到tensorflow模块

问题场景 #

在Anaconda环境DEEPLABCUT中安装DeepLabCut并激活环境后，在ipython中执行import deeplabcut时触发以下报错：

ModuleNotFoundError                       Traceback (most recent call last)
Cell In[1], line 1
----> 1 import deeplabcut

File ~\AppData\Local\anaconda3\envs\DEEPLABCUT\lib\site-packages\deeplabcut\__init__.py:16
     13 import os
     15 # Suppress tensorflow warning messages
---> 16 import tensorflow as tf
     18 tf.compat.v1.logging.set_verbosity(tf.compat.v1.logging.ERROR)
     19 DEBUG = True and "DEBUG" in os.environ and os.environ["DEBUG"]

ModuleNotFoundError: No module named 'tensorflow'

已单独安装tensorflow包，但问题未解决。

排查步骤 #

• 确认tensorflow安装的环境是否正确
  激活DEEPLABCUT环境后，执行conda list或pip list，查看输出中是否有tensorflow条目。如果没有，说明之前安装tensorflow时未激活目标环境，需重新在激活的DEEPLABCUT环境下执行安装命令：

  # conda安装（适配Anaconda环境，推荐使用）
  conda install tensorflow
  # 或pip安装
  pip install tensorflow
  

• 检查ipython是否关联到目标环境
  部分情况下，系统全局ipython不会自动适配激活的Anaconda环境。激活DEEPLABCUT环境后，执行where ipython（Windows）或which ipython（Linux/macOS），确认路径是否指向~\AppData\Local\anaconda3\envs\DEEPLABCUT\Scripts\ipython.exe（Windows）或对应环境的bin目录。若路径不符，先在目标环境安装ipython：

  conda install ipython
  # 或
  pip install ipython
  

  安装完成后再启动ipython尝试导入操作。
• 验证tensorflow能否直接导入
  在激活环境的命令行中，执行python进入交互模式，输入import tensorflow as tf，观察是否能成功导入。若此处也报错，说明tensorflow安装存在问题：
  • 尝试卸载后重装：

    # conda方式
    conda remove tensorflow
    conda install tensorflow
    # pip方式
    pip uninstall tensorflow
    pip install tensorflow
    

  • 注意DeepLabCut对tensorflow版本有特定要求，需匹配对应版本的DeepLabCut文档，安装指定版本的tensorflow（例如旧版DeepLabCut可能需要tensorflow 2.x的特定版本，而非最新版）。
• 检查环境变量与路径冲突
  激活环境后执行echo %PATH%（Windows）或echo $PATH（Linux/macOS），确认DEEPLABCUT环境的Scripts/bin目录是否位于路径最前端，避免其他Python环境的路径优先级高于当前Anaconda环境。

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