python代码打包发布步骤明确且不复杂，主要包括四个关键环节。1. 准备项目结构，确保包含模块代码、测试文件、readme.md、license和setup.py；2. 编写setup.py文件，准确填写项目信息、依赖和分类；3. 使用setuptools和wheel打包，并通过twine上传至pypi；4. 注意版本号唯一性、依赖完整性、许可证添加及readme显示问题，避免常见错误。
python代码打包发布其实不难，但涉及的细节不少。如果你是开发了一个小工具或者库，想分享给别人用，或者部署到服务器上，打包是最直接的方式。
1. 准备你的项目结构
在打包之前，先整理好你的项目目录结构。一个清晰的结构会让打包过程顺利很多。通常推荐这样的结构：
my_project/ │ ├── my_package/ │ ├── __init__.py │ └── module.py │ ├── tests/ │ └── test_module.py │ ├── README.md ├── LICENSE └── setup.py
- my_package 是你写的模块代码。
- tests 是测试代码，可选但建议保留。
- README.md 写清楚项目的用途、安装方式和使用示例。
- LICENSE 声明许可证类型，比如 MIT 或 apache。
- setup.py 是打包的核心文件，必须有。
2. 编写 setup.py 文件
setup.py 是打包的关键配置文件，它告诉 Python 怎么处理你的代码。一个基本的示例如下：
立即学习“Python免费学习笔记（深入）”；
from setuptools import setup, find_packages setup( name='my_package', version='0.1.0', author='Your Name', author_email='your@email.com', description='A small example package', long_description=open('README.md').read(), long_description_content_type='text/markdown', url='https://github.com/yourname/yourrepo', packages=find_packages(), install_requires=[ 'requests', # 如果依赖第三方库，写在这里 ], classifiers=[ 'Programming Language :: Python :: 3', 'License :: OSI Approved :: MIT License', 'Operating System :: OS Independent', ], python_requires='>=3.6', )
这个文件内容看起来多，但大多数字段都是模板化的，照着填就行。关键是确保 name 和 version 正确，并列出依赖项。
3. 打包并上传到 PyPI
打包主要用到两个工具：setuptools 和 wheel。先安装它们：
pip install setuptools wheel
然后执行打包命令：
python setup.py sdist bdist_wheel
这会在 dist/ 目录下生成 .tar.gz 和 .whl 文件。
如果想发布到 PyPI（也就是让别人能通过 pip 安装），还需要安装 twine：
pip install twine
然后上传：
twine upload dist/*
第一次上传前，你需要注册 PyPI 账号，并设置好 API Token。
4. 注意事项和常见问题
- 版本号别重复：一旦传了某个版本号，就不能再传同名的。每次修改后记得升级版本号。
- 依赖写全：不要漏掉依赖库，否则用户安装后会报错。
- 许可证别忘：开源项目最好加个许可证，不然别人不敢随便用。
- README 显示问题：上传到 PyPI 后如果 Readme 没显示出来，检查一下是不是用了不支持的格式或语法。
基本上就这些。整个流程走一遍之后你会发现，打包本身不复杂，但很容易忽略一些小细节，特别是第一次发布的时候。只要按照步骤来，一般都能搞定。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
