使用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, setupsetup( name='mypkg', version='0.1', packages=find_packages() # 自动查找所有子包)
缺少模块：检查py_modules参数
项目中独立的模块（例如bacon.py）需使用py_modules指定：
from setuptools import find_packages, setupsetup( name='mypkg', version='0.1', packages=find_packages(), py_modules=['bacon'])
缺少数据文件：检查package_data参数
包目录下的数据文件（例如data.txt）需通过package_data包含。不要使用data_files，它用于安装包目录外的文件：
from setuptools import find_packages, setupsetup( 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的日志，即可解决此问题，确保所有包文件正确安装。
以上就是pip install .后只生成dist-info文件夹，如何排查Python包安装问题？的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1358539.html
微信扫一扫 
支付宝扫一扫 
![[pcl][原创]python-pcl安装配置支持windows和ubuntu完美流程 2021版本](https://www.chuangxiangniao.com/wp-content/uploads/2025/11/175885039520248.jpg)
![[pcl][原创]python-pcl安装配置支持windows和ubuntu完美流程 2021版本](https://www.chuangxiangniao.com/wp-content/uploads/2025/11/175885039649551.jpg)
![[pcl][原创]python-pcl安装配置支持windows和ubuntu完美流程 2021版本](https://www.chuangxiangniao.com/wp-content/uploads/2025/11/175680099816784-25.png)
