Python通过解压.tar.gz源码包并执行pip install .安装，需先解压、进入目录、确认setup.py或pyproject.toml存在，再运行安装命令；含C扩展时须配置对应平台编译环境。
Python 本身不直接“安装” .tar.gz 文件，而是通过解压后执行其中的安装脚本（通常是 setup.py）来完成模块或软件的安装。这类文件一般是 Python 包的源码分发格式，常见于 PyPI 上没有预编译轮子（wheel）的包，或需要从源码定制编译的场景。
1. 解压 tar.gz 文件
先用系统命令或 Python 解压：
- 终端中（Linux/macOS）：
tar -xzf package-name-1.0.0.tar.gz - Windows 可用 7-Zip、WinRAR，或在 PowerShell 中用
Expand-Archive（PowerShell 5+） - Python 内解压（可选）：
import tarfile
tarfile.open("package.tar.gz").extractall()
2. 进入解压后的目录
解压会生成一个文件夹（如 package-nam），cd 进去：
e-1.0.0/
cd package-name-1.0.0
3. 检查是否有 setup.py 或 pyproject.toml
现代 Python 包通常使用 pyproject.toml（PEP 517/518），老项目用 setup.py。确认存在其中之一：
- 有
setup.py：运行python -m pip install .（点号表示当前目录） - 有
pyproject.toml：同样用python -m pip install .，pip 会自动按标准流程构建安装 - 若需开发模式（修改代码即时生效）：加
-e参数，如pip install -e .
4. 注意依赖和编译环境
源码安装可能需要额外准备：
- 确保已安装
setuptools、wheel、pip的最新版：python -m pip install -U pip setuptools wheel - 若包含 C 扩展（如 NumPy、Cython 模块），需对应平台的编译器：
— Linux：安装build-essential（Debian/Ubuntu）或gcc等
— macOS：安装 Xcode Command Line Tools（xcode-select --install）
— Windows：安装 Microsoft C++ Build Tools 或 Visual Studio（带 C++ 工作负载）
