标签导航:

为什么使用pip install .安装python包时,只创建dist-info文件夹而不安装包本身?

使用pip install .安装Python包时,只创建dist-info文件夹,而未安装包本身,这是一个常见问题。 pip freeze显示包已安装,但import 却报错ModuleNotFoundError: No module named '',site-packages目录下只有dist-info文件夹。即使find_packages()能找到包,问题仍然存在。根本原因通常在于setup.py文件对包结构和配置信息的描述不准确。

让我们用一个例子说明问题和解决方案。假设项目结构如下:

root
├── spam
│   ├── __init__.py
│   ├── data.txt
│   ├── eggs.py
│   └── fizz
│       ├── __init__.py
│       └── buzz.py
├── bacon.py
└── setup.py

执行pip install .后,只有dist-info文件夹被创建,spam和bacon.py等文件未安装。这是因为setuptools未能正确识别和包含这些文件。

可以使用pip install . -vvv命令查看详细安装日志,并用grep 'adding'查找已添加的文件。如果日志中缺少预期文件,则说明这些文件未包含在wheel文件中。

问题通常出在setup.py文件中packages、py_modules和package_data参数的配置错误。

如果包包含子包(如spam和spam.fizz),则必须在packages参数中明确列出所有包,或使用find_packages()自动查找:

from setuptools import find_packages, setup

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

如果项目包含独立模块(如bacon.py),不属于任何包,则需使用py_modules参数:

from setuptools import find_packages, setup

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

如果包包含数据文件(如data.txt),则需使用package_data参数指定数据文件位置:

from setuptools import find_packages, setup

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

切记,不要使用data_files参数处理包内文件,而应使用package_data。

通过仔细检查和正确配置setup.py文件中的这些参数,确保所有需要安装的文件都被包含,即可解决pip install .只创建dist-info文件夹的问题,成功安装Python包。