我来帮你解决这个问题～ 你遇到的情况是因为pydoc默认不会自动识别并链接你的自定义子模块，除非你把src目录变成一个合法的Python包，并且用正确的方式生成文档。下面是具体的原因分析和解决步骤：

一、为什么你的自定义模块没出现在文档里？ #

pydoc生成单个模块（比如main.py）的文档时，只会列出它能正确识别为可导入包/模块的依赖。你的src/cli.py和src/ui.py因为没有被标记为Python包（缺少__init__.py文件），pydoc无法把它们当作可以链接的“正式”模块，自然不会在main的文档里显示它们的引用。

二、具体解决步骤 #

1. 将src目录转为Python包 #

• 在src文件夹下创建一个空的__init__.py文件，这样Python就会把src识别为一个可导入的包。调整后的项目结构如下：

  main.py
  src/
  ├─ __init__.py  # 新增的空文件
  ├─ cli.py
  └─ ui.py
  

• 这个文件可以完全是空的，它的核心作用就是告诉Python：“这个目录是一个标准的Python包”。

2. 生成完整的项目文档（推荐方案） #

• 切换到项目根目录（也就是main.py所在的文件夹），运行以下命令：

  python -m pydoc -w .
  

• 这条命令会遍历当前目录下所有可导入的模块和包，自动生成：
  • main.html：对应main.py的文档
  • src.cli.html：对应src/cli.py的文档
  • src.ui.html：对应src/ui.py的文档
• 生成完成后，打开main.html查看“模块”部分，你会发现src.cli和src.ui的链接已经和标准库、PyQt5的模块一起显示了。

3. 按需生成指定模块的文档 #

如果你不想生成整个项目的文档，只需要main、src.cli和src.ui的文档，可以直接一次性指定这些模块：

• 运行命令：

  python -m pydoc -w main src.cli src.ui
  

• 这样生成的main.html里也会正确包含src.cli和src.ui的链接，因为pydoc现在能正确识别它们是合法的包模块。

三、验证设置是否正确 #

在运行pydoc命令前，你可以先在Python交互环境里测试导入是否正常，确保没有报错：

from src.cli import CommandLineTool
from src.ui import UserInterfaceTool

如果导入成功，说明包的设置是正确的，再运行pydoc命令就可以得到预期的文档啦～