Python本地安装包失败：仅生成dist-info文件夹，缺少实际包文件
使用pip install .进行本地Python包安装时，常常遇到一个问题：pip freeze显示包已安装，但import <package_name></package_name>却提示ModuleNotFoundError: No module named '<package_name>'</package_name>，且site-packages目录下只有dist-info文件夹。本文将分析此问题并提供解决方案。
问题根源在于pip install .在构建wheel文件时失败，导致包文件未正确安装。find_packages()能找到包，说明包的目录结构没问题，问题在于setuptools配置导致wheel文件构建不完整。
排查步骤：
立即学习“Python免费学习笔记（深入）”；
首先，确认问题所在。使用pip show -f <package_name></package_name>查看安装文件列表，你会发现只有dist-info文件夹下的文件，缺少实际的包文件。
检查wheel构建日志：
为了精准定位问题，先用pip uninstall -y <package_name></package_name>卸载包，再用pip install . -vvv重新安装，并用pip install . -vvv | grep 'adding'查看日志，观察哪些文件被添加到wheel文件中。
常见错误及解决方案：
- 包缺失：检查
packages参数
如果项目包含多个包（例如，主包和子包），仅在setup()函数中指定父包是不够的。需要明确指定所有需安装的包。建议使用setuptools.find_packages()自动查找所有包，避免手动指定路径，更便捷且不易出错。
正确的setup()函数示例：
from setuptools import find_packages, setup
setup(
name='mypkg',
version='0.1',
packages=find_packages() # 自动查找所有包
)
- 模块缺失：检查
py_modules参数
如果项目包含不在任何包内的独立模块，需使用py_modules参数指定这些模块。
例如：
from setuptools import find_packages, setup
setup(
name='mypkg',
version='0.1',
packages=find_packages(),
py_modules=['bacon'] # bacon.py 为独立模块
)
- 数据文件缺失：检查
package_data参数
包目录下的数据文件（配置文件、文本文件等）需通过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参数，即可解决“点安装，只创建dist-info而不是包”的问题。再次运行pip install . -vvv，并检查日志和pip show -f <package_name></package_name>的输出，验证所有文件是否已正确安装。
