解决 TensorBoard 启动报错：ModuleNotFoundError: No module named ‘pkg_resources‘

遇到pkg_resources缺失？别慌，大概率是setuptools版本太高惹的祸。

问题现象

在 Conda 环境中执行tensorboard命令时，出现如下错误：

Traceback (most recent call last): File "/ai/wystor/miniconda3/envs/emomra/bin/tensorboard", line 3, in <module> from tensorboard.main import run_main File "/ai/wystor/miniconda3/envs/emomra/lib/python3.11/site-packages/tensorboard/main.py", line 27, in <module> from tensorboard import default File "/ai/wystor/miniconda3/envs/emomra/lib/python3.11/site-packages/tensorboard/default.py", line 30, in <module> import pkg_resources ModuleNotFoundError: No module named 'pkg_resources'

环境信息

• Python 3.11
• setuptools版本：82.0.1（过高）

原因分析

pkg_resources是setuptools提供的模块，负责管理 Python 包的入口点、资源等。旧版 TensorBoard（以及许多其他旧工具）在启动时会直接import pkg_resources。

• setuptools≤ 59.x：pkg_resources为核心组件，默认包含。
• setuptools≥ 60.0.0：开始逐步重构，pkg_resources不再默认内置。
• setuptools≥ 70.x：彻底移除直接可用的pkg_resources，需要额外安装兼容包。
• 82.0.1：已完全不再内置pkg_resources。

因此，当您使用新版setuptools运行旧版 TensorBoard 时，就会触发No module named 'pkg_resources'。

解决方案

降级 setuptools（最稳妥、最快捷）

将setuptools降级到81.0.0（经测试，该版本仍然完整支持pkg_resources）：

conda activate emomra pipinstall'setuptools==81.0.0'

或使用 conda：

condainstallsetuptools=81.0.0

验证修复：

python-c"import pkg_resources; print('pkg_resources 可用')"

若输出成功，说明问题已解决。

注意：后续若执行pip install --upgrade可能会再次升级setuptools，建议使用固定版本安装命令：

pipinstall'setuptools==81.0.0'--no-cache-dir