使用pip安装自己编写的Python包

作者：YXN 阅读量：73 发布日期：2025-01-06

1. 准备包结构

要求项目目录结构符合Python包规范：

my_package/
├── my_package/       # 包主目录
│   ├── __init__.py   # 必须的空文件（包标识）
│   └── your_code.py  # 你的代码文件
├── setup.py          # 包配置元数据
└── README.md         # 项目说明（可选）

2. 编写 setup.py 文件

from setuptools import setup, find_packages

setup(
    name="my_package",          # 包名称（需唯一）
    version="0.1",              # 版本号
    packages=find_packages(),   # 自动发现包目录
    install_requires=[          # 依赖包列表（可选）
        "requests>=2.25.1",
    ],
)

3. 生成分发包（可选）

在项目根目录执行以下命令生成 .whl 或 .tar.gz 文件：

# 安装构建工具
pip install wheel build

# 构建分发包（生成到 dist/ 目录）
python -m build

4. 安装你的包

方法一：直接从源码安装（推荐开发时使用）

# 在项目根目录执行
pip install .

方法二：安装本地分发包

pip install dist/my_package-0.1-py3-none-any.whl  # 替换为实际文件名

方法三：开发模式安装（代码修改实时生效）

pip install -e .  # 创建符号链接，适合开发调试

验证安装

import my_package
print(my_package.__version__)  # 应该输出 0.1

常见问题

权限问题：如果出现权限错误，尝试添加 --user 参数：

pip install --user .

清理旧版本：升级前建议先卸载旧版本：

pip uninstall my_package

依赖处理：确保 setup.py 中列出的依赖包已正确安装

通过以上步骤，你的自定义包就可以像标准库一样被其他Python代码引用了。如果需要发布到PyPI，可使用 twine upload dist/* 命令。

 

 

YXN

2025-01-06