Python3.8环境下pip list可见模块未在help('modules')显示原因问询

• help('modules')的扫描逻辑与pip、import的逻辑存在差异：help('modules')运行时会全量遍历sys.path下的所有目录，同时尝试导入每个扫描到的模块以验证有效性，过程中会自动跳过权限不足的目录、命名不符合规范的模块文件。而pip list仅读取Python包管理数据库的元数据，import仅检查目标模块的搜索路径是否在sys.path中且可正常加载，不需要全量扫描所有路径，所以不会出现和help('modules')一样的漏判问题。
• 模块安装路径的权限配置异常：管理员大概率将新模块安装到了自定义的第三方包路径，该路径虽然已经添加到当前用户的PYTHONPATH或全局sys.path中，但help('modules')运行时没有该路径的遍历读权限，无法扫描路径下的模块文件，就会漏掉这些新增模块。
• 离线安装流程不规范，缺少模块索引更新：离线环境下管理员如果直接通过解压wheel/egg包、手动拷贝模块源码/编译后文件的方式安装模块，没有走标准的pip install流程，可能会导致模块的元数据没有写入help()工具依赖的全局模块索引，就不会被help('modules')扫描到，但不影响正常导入和pip list的识别（如果pip的元数据已单独更新）。
• 内置模块列表缓存未更新：help('modules')会优先读取本地缓存的模块列表数据，如果管理员安装完新模块后没有触发该缓存的更新，也会导致新模块不在扫描结果中。

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