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

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

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

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

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

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

立即学习“Python免费学习笔记（深入）”；

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

豆包爱学

豆包旗下AI学习应用

674

查看详情

如果包包含子包（如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包。

以上就是为什么使用pip install .安装Python包时，只创建dist-info文件夹而不安装包本身？的详细内容，更多请关注php中文网其它相关文章！