从tensorflow.keras.utils导入to_categorical失败求助

问题现象 #

• 代码中使用的导入语句：

  from tensorflow.python.keras.utils import to_categorical
  

• PyCharm提示错误：Cannot find reference 'to_categorical' in '__init__.py'
• 当前已安装TensorFlow版本为2.15.0

原因分析 #

tensorflow.python.keras属于TensorFlow的内部实现路径，并非官方推荐的公开API入口，PyCharm的静态代码分析无法正确识别内部模块结构；同时在TensorFlow 2.x版本中，to_categorical的标准导入路径已调整为tensorflow.keras.utils。

解决方案 #

1. 替换为官方推荐的导入路径 #

将导入语句修改为以下任一写法：

# 直接导入
from tensorflow.keras.utils import to_categorical

# 或通过tensorflow模块间接调用
import tensorflow as tf
y_categorical = tf.keras.utils.to_categorical(your_labels)

官方始终推荐使用tensorflow.keras作为公开API入口，避免依赖内部路径导致的兼容性问题。

2. 确认PyCharm解释器配置 #

• 打开File > Settings > Project: [项目名] > Python Interpreter
• 检查当前选中的解释器是否为安装了TensorFlow的环境（比如虚拟环境）
• 若不一致，切换到正确的解释器并保存配置

3. 刷新PyCharm缓存 #

若导入路径正确但仍报错，大概率是IDE缓存问题：

• 点击File > Invalidate Caches...
• 选择Invalidate and Restart，重启后IDE会重新生成代码索引

4. 验证TensorFlow安装有效性 #

在终端运行以下代码，确认函数是否存在：

import tensorflow as tf
print(tf.keras.utils.to_categorical)

若输出<function to_categorical at 0x...>则安装正常；若报错，重新安装TensorFlow：

pip uninstall tensorflow tensorflow-intel
pip install tensorflow

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