为什么需要安装本地 Python 包?
在以下场景中,你可能需要使用 pip 安装本地的 Python 包:
- 没有网络连接(如内网或离线环境)
- 正在开发自己的 Python 包并希望测试安装效果
- 需要安装特定版本的包而不从 PyPI 下载
- 分发私有包给团队成员
准备工作
确保你已安装 Python 和 pip。可通过以下命令检查:
python --version pip --version
建议使用虚拟环境以避免污染全局 Python 环境:
python -m venv myenv source myenv/bin/activate # Linux/macOS # 或 myenv\Scripts\activate # Windows
方法一:安装 .whl 文件
.whl 是 Python 的二进制分发格式,安装速度快。
pip install /path/to/package.whl
提示:你可以使用相对路径或绝对路径。例如:
pip install ./dist/my_package-1.0.0-py3-none-any.whl
方法二:安装源码目录(含 setup.py)
如果你有一个包含 setup.py 的项目目录,可以直接安装:
pip install /path/to/source/directory
例如:
pip install ./my_python_project
注意:该目录必须包含有效的
setup.py 或 pyproject.toml 文件。
方法三:安装 .tar.gz 压缩包
许多开源项目提供 .tar.gz 格式的源码发布包:
pip install /path/to/package.tar.gz
pip 会自动解压并执行安装流程。
常用选项
--force-reinstall:强制重新安装包--no-deps:不安装依赖-e或--editable:以“可编辑”模式安装(开发模式),修改源码后无需重新安装
示例(开发模式安装):
pip install -e ./my_project
常见问题
Q:安装时报错 “not a supported wheel on this platform”?
A:说明 .whl 文件与当前系统或 Python 版本不兼容,请确认平台匹配或改用源码安装。
Q:如何生成 .whl 文件?
A:在项目根目录运行:
pip install build python -m build生成的文件位于
dist/ 目录下。