为什么需要安装本地 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/ 目录下。