Python自制库并通过pip仅安装到本机（无需提交PyPI）

Leo

发布时间：2026-10-13 | 2人浏览过

原创

本文介绍如何快速创建Python自制包并仅安装到本机，无需提交至PyPI。通过规范的目录结构、编写setup.py配置文件，执行sdist和bdist_wheel命令生成发行版，最后使用pip直接安装生成的tar.gz文件，即可实现本地代码复用与管理。

Python本地包制作与安装指南

Python生态中用于打包和分发库的工具繁多且容易令人困惑，例如setuptools、distutils、wheel以及早期的egg格式等，让人难以抉择。

我的核心需求是创建一个自定义包来管理个人常用代码，并不打算将其发布到PyPI公共仓库，仅希望能在本机环境中进行安装和使用。

以下是实现这一目标的关键操作步骤。

目录结构布局

首先，需要建立清晰的文件目录结构。

├── package1 │ └──-├── init .py | |── mod1.py │ └── mod2.py ├── setup.py |── README.md

配置setup.py文件

接下来，编写核心的setup.py文件，其内容大致如下所示：

构建与安装示例


from setuptools import setup, find_packages

setup(
  name="kamustools",
  version="1.0.1",
  author="Kamuszhou",
  author_email="zausiu@gmail.com",
  description="tools used by kamuszhou exclusively.",
  license="BSD",
  keywords="kamus",
  url="https://blog.ykyi.net",
  packages=find_packages(),
  long_description="Long descrition is actually short...",
  classifiers=[
    "Development Status :: 3 - Alpha", 
    "Topic :: Utilities",
    "License :: OSI Approved :: BSD License",
  ],
)

3. 执行命令 python3 setup.py sdist bdist_wheel 来构建源码分发包和wheel包。

4. 使用 pip install ./dist/kamustools-1.0.1.tar.gz 命令将生成的压缩包安装到当前Python环境中。

整个过程仅需这四步，其他复杂功能可在后续使用中逐步探索。鉴于打包工具链确实庞杂，这里仅记录满足个人基本需求的简化流程。

总结

以上介绍了如何制作Python自制包并通过pip仅安装到本机，无需提交至PyPI，希望能对大家有所帮助。如有任何疑问，欢迎留言交流，小编会及时回复。感谢大家对本站的支持！如果你觉得本文对你有帮助，欢迎转载，烦请注明出处，谢谢！