导入TensorFlow报错：ValueError: The proto value '6' is already registered

问题场景 #

本地VSCode中运行.ipynb文件，执行import tensorflow as tf时触发上述错误，此前该导入语句可正常运行，单独保留TensorFlow导入仍报错；但在Kaggle内核中导入TensorFlow无异常。

错误成因 #

• Protobuf版本冲突：TensorFlow对protobuf（Protocol Buffers）的版本有严格依赖要求。如果后续安装/更新了其他依赖protobuf的第三方库（如grpc、pyarrow、pandas等），这些库可能要求或自带与TensorFlow不兼容的protobuf版本。当不同版本的protobuf或依赖它的库对枚举值的注册逻辑冲突时，就会出现“值6已被注册”的错误——TensorFlow尝试注册内部枚举类型时，发现该值已被其他库占用。
• TensorFlow安装文件损坏：之前能正常运行，可能是后续的异常操作（如pip更新中断、磁盘写入错误、误修改site-packages中TensorFlow的相关文件）导致TensorFlow内部与protobuf枚举注册相关的文件损坏，使得导入时无法正确校验枚举值的唯一性。
• 全局Python环境依赖混乱：若未使用虚拟环境隔离项目依赖，多个项目的不同版本包会相互干扰。比如其他项目安装的protobuf版本覆盖了TensorFlow所需的特定版本，进而引发枚举注册的冲突问题。

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