Python本地安装包失败：为什么只有dist-info文件夹而没有实际的包文件？

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文件中。

常见错误及解决方案：

FashionLabs

AI服装模特、商品图，可商用，低价提升销量神器

38

查看详情

1. 包缺失：检查packages参数

如果项目包含多个包（例如，主包和子包），仅在setup()函数中指定父包是不够的。需要明确指定所有需安装的包。建议使用setuptools.find_packages()自动查找所有包，避免手动指定路径，更便捷且不易出错。

正确的setup()函数示例：

from setuptools import find_packages, setup

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

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

如果项目包含不在任何包内的独立模块，需使用py_modules参数指定这些模块。

例如：

from setuptools import find_packages, setup

setup(
    name='mypkg',
    version='0.1',
    packages=find_packages(),
    py_modules=['bacon']  # bacon.py 为独立模块
)

3. 数据文件缺失：检查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>的输出，验证所有文件是否已正确安装。

以上就是Python本地安装包失败：为什么只有dist-info文件夹而没有实际的包文件？的详细内容，更多请关注php中文网其它相关文章！