解决TensorBoard启动时的pkg_resources模块缺失问题

1. 问题现象与初步诊断

最近在调试TensorFlow项目时，当我尝试启动TensorBoard可视化工具时，终端突然抛出"ModuleNotFoundError: No module named 'pkg_resources'"的错误。这个报错看似简单，却让我的调试工作停滞了近两个小时。作为Python生态中常见的依赖管理工具组件，pkg_resources模块的缺失会直接影响setuptools的正常运作，进而导致TensorBoard这类依赖复杂的工具无法启动。

具体报错信息通常呈现为：

code复制Traceback (most recent call last):
  File "/usr/local/bin/tensorboard", line 5, in <module>
    from tensorboard.main import run_main
  File "/usr/local/lib/python3.8/site-packages/tensorboard/__init__.py", line 37, in <module>
    from tensorboard import version
  File "/usr/local/lib/python3.8/site-packages/tensorboard/version.py", line 23, in <module>
    import pkg_resources
ModuleNotFoundError: No module named 'pkg_resources'

从堆栈信息可以清晰看到，问题发生在导入tensorboard.version模块时，系统无法找到pkg_resources这个基础模块。这种情况在Python环境中其实并不罕见，特别是在以下场景：

• 使用较新版本的Python（3.12+）时，setuptools的默认安装方式有变化
• 通过源码编译安装Python时遗漏了ensurepip模块
• 虚拟环境创建时未正确继承基础环境的包
• 系统级Python环境被意外修改或损坏

关键提示：pkg_resources是setuptools包的核心组件，负责处理Python包的版本管理和资源访问。它的缺失意味着Python的包管理系统出