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-name-1.0.0/），cd 进去：

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++ 工作负载）