您访问了 PyInstaller 的官方 PyPI 项目页面。该页面是获取 PyInstaller 所有官方发布版本和相关文件（如源码包、分发包）的权威来源。对于网络受限或需要精确版本控制的离线环境，此页面是下载安装包的首选途径。 #### **页面核心内容解读** 1. **主要文件类型**: 通常包含 `.tar.gz` 源码归档文件和适用于特定 Python 版本的 `.whl` 分发包（Wheel 文件）[ref_1][ref_2][ref_6]。 2. **版本历史**: 页面会列出所有历史版本，方便用户回退到特定版本以解决兼容性问题。 3. **依赖提示**: 官方文档或页面说明通常会指出关键的运行时依赖，例如 `pefile`, `altgraph`, `pywin32-ctypes` (Windows) 等 [ref_1][ref_3]。 4. **安装命令**: 页面顶部会显示标准的在线安装命令 `pip install pyinstaller` [ref_2][ref_4]。 #### **离线安装场景下的核心步骤** 基于该官方页面，完整的离线安装流程如下： **第一步：在可联网的机器上下载安装包** 您需要从 `https://pypi.org/project/pyinstaller/#files` 页面下载所有必需的包。 ```bash # 示例：假设要下载 PyInstaller 及其关键依赖（以特定版本为例） # 1. 下载 PyInstaller 源码包或 Wheel 包 # 例如：pyinstaller-5.13.0.tar.gz # 例如：pyinstaller-5.13.0-py3-none-any.whl # 2. 下载核心依赖包（包名和版本需根据 PyInstaller 版本要求确定） # 常见的依赖可能包括： # - future # - pefile # - altgraph # - pywin32-ctypes (Windows 系统必需) [ref_1][ref_3][ref_4] # 这些依赖包同样需要从 PyPI 或其 GitHub 仓库下载对应的 .tar.gz 或 .whl 文件 [ref_1]。 ``` **第二步：将下载的包传输到离线环境** 将所有下载的 `.tar.gz` 或 `.whl` 文件通过 U 盘、内部网络或其他介质复制到目标离线计算机上。 **第三步：在离线环境中安装** 在离线环境的命令行中，导航到存放这些包的目录，并按顺序安装。 * **方法 A：使用 `pip install` 直接安装本地包文件** ```bash # 安装依赖包 pip install future-1.0.0.tar.gz pip install pefile-2023.2.7.tar.gz pip install altgraph-0.17.4.tar.gz # Windows 系统必须安装 pywin32-ctypes pip install pywin32_ctypes-0.2.0.tar.gz # [ref_1][ref_3] # 最后安装 PyInstaller 主包 pip install pyinstaller-5.13.0.tar.gz ``` *优势：`pip` 会自动处理包的元数据。* * **方法 B：使用 `setup.py` 进行源码安装（通用方法）** ```bash # 解压源码包 tar -zxvf pyinstaller-5.13.0.tar.gz # 进入解压后的目录 cd pyinstaller-5.13.0 # 执行安装 python setup.py install # [ref_1][ref_2] ``` *注意：此方法需要提前手动安装所有依赖包。* **第四步：验证安装** 安装完成后，运行以下命令验证 PyInstaller 是否安装成功： ```bash pyinstaller --version # 或 python -m PyInstaller --version ``` #### **常见问题与解决策略** | 问题场景 | 可能原因 | 解决方案 | | :--- | :--- | :--- | | `pip install pyinstaller` 失败，提示与 `pywin32` 或构建依赖相关 | 网络问题、权限问题或特定系统依赖缺失 [ref_4][ref_6]。 | **首选离线安装**：从官方 PyPI 页面下载完整包进行手动安装 [ref_4]。<br>**更新工具**：尝试升级 `pip`, `setuptools`, `wheel`：`python -m pip install --upgrade pip setuptools wheel` [ref_4]。 | | 在特殊架构（如 mips64）或国产系统中安装失败 | 缺少底层 C 库（如 `glibc`, `zlib`）或编译器不兼容 [ref_5]。 | 1. 确保系统已安装 `gcc` 编译器及 `zlib`, `libdl` 等开发库 [ref_5]。<br>2. 可能需要从源码编译安装这些 C 库 [ref_5]。<br>3. 最后再尝试通过源码 (`setup.py`) 方式安装 PyInstaller。 | | 打包执行时出现 `libz.so.1` 等动态库错误 | 目标系统的动态链接库版本或路径不匹配 [ref_5]。 | 检查并确保系统中存在正确的 `libz` 库。可能需要创建软链接或将特定版本的库文件放置到链接器可找到的路径 [ref_5]。 | #### **总结与最佳实践建议** 对于网络环境良好、无特殊系统限制的标准 Windows/Linux/macOS 环境，直接使用 `pip install pyinstaller` 是最便捷的方式 [ref_3]。**但对于公司内网、生产服务器、特定硬件架构（如ARM、mips64 [ref_5]）或需要固定版本的环境，强烈建议采用离线安装方案**。其核心流程可概括为：**“官网查找版本 -> 联网机下载包 -> 离线环境手动安装”**。通过访问您提供的 `https://pypi.org/project/pyinstaller/#files` 页面，您可以精确获取所需版本的文件，这是完成离线安装最关键的第一步 [ref_1][ref_2][ref_6]。