使用pip install .安装Python包时，仅生成dist-info文件夹，而非实际的包文件，这会导致import 失败。本文将指导您排查此问题。
问题根源在于setup.py文件配置错误，导致构建的wheel文件不完整。pip show -f 只会显示dist-info文件夹内容，缺少实际的包文件。
诊断步骤：分析wheel构建日志
pip默认构建wheel文件进行安装。使用-vvv参数可查看详细构建日志，找出问题所在。
立即学习“Python免费学习笔记（深入）”；
-
卸载已安装的包:
pip uninstall -y -
重新安装并查看日志:
pip install . -vvv | grep 'adding'观察哪些文件被添加到wheel文件中。缺少预期文件则需检查setup.py。
常见错误及解决方法
-
缺少包：检查
packages参数如果包包含子包，仅指定父包不足以包含所有子包。使用
setuptools.find_packages()自动查找所有子包：from setuptools import find_packages, setup setup( name='mypkg', version='0.1', packages=find_packages() # 自动查找所有子包 ) -
缺少模块：检查
py_modules参数项目中独立的模块（例如
bacon.py）需使用py_modules指定：from setuptools import find_packages, setup setup( name='mypkg', version='0.1', packages=find_packages(), py_modules=['bacon'] ) -
缺少数据文件：检查
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的日志，即可解决此问题，确保所有包文件正确安装。
