Python：为什么 pip install 不从 sdist 部署我的代码

TL；DR因为find_packages(include=["PackageA.PackageB"])会过滤掉父级PackageA，所以它不包括在安装中.使用

setup(
    packages=find_packages(),
    ...
)

一切都会好起来的.

更详细的解释是，include arg并不意味着"除了find_packages()发现的以外还包括".它的意思是"只包含find_packages()找到的、在include过滤器列表中的包"，因此它只能缩小包 Select .比较

$ python -c "from setuptools import find_packages as f; print(f())"
['PackageA', 'PackageA.PackageB']

vs

$ python -c "from setuptools import find_packages as f; print(f(include=['PackageA.PackageB']))"
['PackageA.PackageB']

由于PackageA不包括在内，PackageA/__init__.py将在源代码分发中被省略，从而有效地从PackageA中删除包属性——在tar归档中，它现在将是一个常规目录.运行pip install mydist.tar.gz将无法再找到PackageA，因此PackageA.PackageB也无法找到.因此，不会安装任何设备.setuptools个文档中的Automatic package discovery部分简短地提到了find_packages()的include和exclude个参数，但更有用的是函数的docstring:

>>> from setuptools import find_packages
>>> help(find_packages)
find(where='.', exclude=(), include=('*',)) method of builtins.type instance
    Return a list all Python packages found within directory 'where'

    ...

    'include' is a sequence of package names to include.  If it's
    specified, only the named packages will be included.  If it's not
    specified, all found packages will be included.  'include' can contain
    shell style wildcard patterns just like 'exclude'.