导出Python包，这事儿说起来简单，但真要搞明白，里面门道可不少。别的不说，光是打包方式，就够你研究一阵子了。我当年第一次想把自己的小项目分享给朋友，结果就卡在了导出包这个环节，折腾了半天才搞定，那个酸爽，至今难忘。所以今天我就把我这些年踩过的坑、总结的经验，都一股脑儿地分享给你，保证你以后再也不用为导出Python包发愁。
咱们先说最常见的，也是我最推荐的方式：使用 setuptools。这玩意儿几乎是Python打包的标配，功能强大，使用也相对简单。
首先，你需要一个 setup.py 文件。 这个文件就是你的包的“身份证”，告诉Python你的包叫什么名字，版本号是多少，依赖哪些其他的包等等。
举个例子，假设你有一个项目，目录结构是这样的：
my_package/
my_module.py
__init__.py
你的 setup.py 文件可能长这样：
“`python
from setuptools import setup, find_packages
setup(
name=’my_package’,
version=’0.1.0′,
packages=find_packages(),
install_requires=[
# 这里列出你的包依赖的其他包，比如：
# ‘requests’,
# ‘numpy’,
],
author=’你的名字’,
author_email=’你的邮箱’,
description=’一个简单的Python包’,
long_description=open(‘README.md’).read(), # 可以从README文件读取详细描述
long_description_content_type=’text/markdown’, # 说明README文件是markdown格式的
url=’你的项目地址（如果有的话）’,
classifiers=[
‘Programming Language :: Python :: 3’,
‘License :: OSI Approved :: MIT License’,
‘Operating System :: OS Independent’,
],
python_requires=’>=3.6′,
)
“`
看到没？这里面包含了你的包的各种信息，比如 name 是包的名字，version 是版本号，packages 是告诉 setuptools 去哪里找你的包。 find_packages() 会自动找到项目目录下的所有包含 __init__.py 文件的文件夹，并将它们作为包包含进去。 install_requires 则是列出你的包所依赖的其他包，这样别人在安装你的包的时候，会自动安装这些依赖。long_description可以从README.md文件中读取详细的项目描述，这对于展示你的项目功能非常重要，别忘了加上。
然后，打开你的命令行，进入到包含 setup.py 文件的目录，执行以下命令：
bash
python setup.py sdist bdist_wheel
这条命令会做两件事：
sdist：创建一个源代码发行包（source distribution），通常是一个.tar.gz文件。bdist_wheel：创建一个 wheel 文件，这是一种二进制发行包，安装起来更快更方便。
执行完之后，你会发现你的项目目录下多了一个 dist 文件夹，里面就包含了你打包好的 .tar.gz 文件和 .whl 文件。
有了这些文件，你就可以把它们分享给你的朋友，或者上传到 PyPI（Python Package Index）上，让全世界的人都可以使用你的包了。
上传到 PyPI 也很简单，你需要先注册一个 PyPI 账号，然后安装 twine：
bash
pip install twine
接着，使用 twine 上传你的包：
bash
twine upload dist/*
twine 会提示你输入 PyPI 的用户名和密码，输入正确后，你的包就会被上传到 PyPI 上了。
上传成功后，别人就可以通过 pip install my_package 来安装你的包了，是不是很酷？
当然，setuptools 还有很多其他的用法，比如你可以自定义安装脚本，添加额外的文件到你的包里等等。这些就留给你自己去探索了。
除了 setuptools，还有其他的打包工具，比如 poetry 和 pdm。 这两个工具都是比较新的，它们试图解决 setuptools 的一些痛点，比如依赖管理、虚拟环境等等。
poetry 的使用方式也很简单。 首先，你需要安装 poetry：
bash
pip install poetry
然后，进入你的项目目录，执行 poetry init：
bash
poetry init
poetry init 会引导你创建一个 pyproject.toml 文件，这个文件类似于 setup.py，包含了你的包的各种信息。
填写完 pyproject.toml 文件后，你可以使用 poetry build 命令来打包你的包：
bash
poetry build
poetry build 会在 dist 目录下生成 .tar.gz 文件和 .whl 文件。
上传到 PyPI 的方式也类似，使用 poetry publish 命令：
bash
poetry publish
poetry 会自动读取 pyproject.toml 文件中的信息，并上传你的包到 PyPI。
总的来说，poetry 比 setuptools 更加现代化，使用起来也更方便。但 setuptools 仍然是Python打包的主流，所以建议你两种方式都了解一下。
还有一些小技巧，分享给你：
- 写好
README.md文件。 一个好的README.md文件可以帮助别人更好地了解你的包，提高你的包的曝光率。 - 添加详细的注释。 良好的代码注释可以帮助别人更容易地理解你的代码，方便别人使用你的包。
- 编写单元测试。 编写单元测试可以保证你的代码质量，避免出现 Bug。
导出Python包，不仅仅是把你的代码打包起来，更重要的是分享你的智慧，让更多的人受益。希望这篇文章能够帮助你更好地导出你的Python包，让你的代码在更广阔的世界里发光发热！记住，遇到问题不要怕，多查资料，多尝试，总能找到解决办法的！祝你一切顺利！
评论(0)