pip install .后只生成dist-info文件夹，如何排查Python包安装问题？

使用pip install .安装Python包时，仅生成dist-info文件夹，而非实际的包文件，这会导致import <package></package>失败。本文将指导您排查此问题。

问题根源在于setup.py文件配置错误，导致构建的wheel文件不完整。pip show -f <package></package>只会显示dist-info文件夹内容，缺少实际的包文件。

诊断步骤：分析wheel构建日志

pip默认构建wheel文件进行安装。使用-vvv参数可查看详细构建日志，找出问题所在。

立即学习“Python免费学习笔记（深入）”；

1. 卸载已安装的包: pip uninstall -y <package></package>
2. 重新安装并查看日志: pip install . -vvv | grep 'adding' 观察哪些文件被添加到wheel文件中。缺少预期文件则需检查setup.py。

常见错误及解决方法

1. 缺少包：检查packages参数

   

   Short AI

   AI短视频生成器，轻松创作爆款短视频！

   下载

   如果包包含子包，仅指定父包不足以包含所有子包。使用setuptools.find_packages()自动查找所有子包：

   from setuptools import find_packages, setup
   
   setup(
       name='mypkg',
       version='0.1',
       packages=find_packages()  # 自动查找所有子包
   )

2. 缺少模块：检查py_modules参数

   项目中独立的模块（例如bacon.py）需使用py_modules指定：

   from setuptools import find_packages, setup
   
   setup(
       name='mypkg',
       version='0.1',
       packages=find_packages(),
       py_modules=['bacon']
   )

3. 缺少数据文件：检查package_data参数

   包目录下的数据文件（例如data.txt）需通过package_data包含。不要使用data_files，它用于安装包目录外的文件：

   from setuptools import find_packages, setup
   
   setup(
       name='mypkg',
       version='0.1',
       packages=find_packages(),
       package_data={'spam': ['data.txt']},  # 'spam'包包含'data.txt'
       py_modules=['bacon']
   )

通过检查setup.py中的packages、py_modules和package_data参数，并结合pip install . -vvv的日志，即可解决此问题，确保所有包文件正确安装。