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

wufei123 2025-03-12 阅读:18 评论:0

使用pip install .安装Python包时，只创建dist-info文件夹，而未安装包本身，这是一个常见问题。 pip freeze显示包已安装，但import 却报错ModuleNotFoundError: No module...

为什么使用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文件对包结构和配置信息的描述不准确。

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

PHP

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()自动查找：

PHP

from setuptools import find_packages, setup

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

如果项目包含独立模块（如bacon.py），不属于任何包，则需使用py_modules参数：

PHP

from setuptools import find_packages, setup

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

如果包包含数据文件（如data.txt），则需使用package_data参数指定数据文件位置：

PHP

from setuptools import find_packages, setup

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