使用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()能找到包，问题依然存在。

根本原因：pip install .会构建一个wheel文件再进行安装。如果构建过程出错，导致部分文件未包含进wheel文件，就会出现上述问题。

排查步骤：

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

假设项目结构如下：

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

使用pip install .后，pip list显示包已安装，但pip show -f <package></package>显示缺少spam、bacon.py等文件，只有dist-info元数据。

这时，需要检查wheel构建日志。先卸载包：pip uninstall -y <package></package>，然后以详细模式重新安装：pip install . -vvv。通过pip install . -vvv | grep 'adding'查看日志，确认哪些文件被添加到wheel文件中。如果缺少文件（例如上述例子中spam目录下的文件和bacon.py），则说明这些文件未被正确包含。

常见错误及解决方法：

Joker AIx

一站式AI创意生产平台，覆盖图像、视频、音频、文案全品类创作

下载

1. 包缺失：检查packages参数

   如果setup.py中packages参数只指定父包（例如packages=['spam']），子包（如spam.fizz）不会被自动包含。解决方法：明确列出所有包，或使用setuptools.find_packages()自动查找：

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

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

   对于不在任何包中的模块（例如bacon.py），需要使用py_modules参数指定：

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

3. 数据文件缺失：检查package_data参数

   包目录下的数据文件（如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中的packages、py_modules和package_data参数，结合pip install . -vvv的日志信息，就能有效诊断和解决这个问题，确保所有必要文件都被包含在安装包中。