Python项目打包与发布全攻略

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Python项目打包发布指南》，聊聊，我们一起来看看吧！

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 怎么处理你的代码。一个基本的示例如下：

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 没显示出来，检查一下是不是用了不支持的格式或语法。

基本上就这些。整个流程走一遍之后你会发现，打包本身不复杂，但很容易忽略一些小细节，特别是第一次发布的时候。只要按照步骤来，一般都能搞定。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~