Python 离线安装 PyInstaller 的完整步骤（以python3.11.4-amd64.exe为例）
在实际工作中，很多部署环境没有网络连接，例如某些生产服务器、内网开发机等。这种情况下我们无法通过 pip install pyinstaller 直接安装 PyInstaller。
本篇文章将详细介绍如何在离线环境中为 Python 3.11.4（64位）安装 PyInstaller，并提供完整的操作命令与解释，适用于需要在离线环境打包 .exe 或 .so 文件的场景。
前提条件
-
目标机器已经安装 Python 3.11.4 amd64。
-
已正确配置
python和pip命令。 -
一台可以访问互联网的电脑，用于提前下载依赖包
🧰 步骤一：在联网电脑上下载 PyInstaller 及依赖
1.打开终端（Windows CMD、PowerShell 或 Linux Shell）
2.创建用于存放安装包的目录：
mkdir pyinstaller_offline
cd pyinstaller_offline
3.使用 pip 下载 PyInstaller 及其所有依赖（建议指定国内镜像源以提高速度）：
pip download pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple
完成后，当前目录下会包含一系列 .whl 和 .tar.gz 安装包：
pyinstaller-5.13.2-py3-none-any.whl
pyinstaller_hooks_contrib-2023.6-py2.py3-none-any.whl
altgraph-0.17.4-py2.py3-none-any.whl
...
💾 步骤二：将下载的文件复制到离线机器
你可以使用 U盘、移动硬盘或通过内网传输将整个 pyinstaller_offline 文件夹复制到目标离线设备。
🔧 步骤三：在离线电脑上执行安装
1.打开终端，进入包目录：
cd pyinstaller_offline
2.使用 pip 离线安装：
pip install --no-index --find-links=. pyinstaller
🔍 参数说明：
| 参数 | 说明 |
|---|---|
--no-index | 禁止 pip 从 PyPI 下载安装包（即完全离线） |
--find-links=. | 从当前目录中查找可用的 .whl 包 |
pyinstaller==5.13.2 | 指定需要安装的版本 |
✅ 步骤四：验证安装是否成功
安装完成后，执行以下命令：
pyinstaller --version
如果输出如下，即表示安装成功：
5.13.2
📝 总结
通过上述步骤，你可以在完全离线的机器上成功安装 PyInstaller，并用于打包你的 Python 项目。在实际使用中，你也可以用同样的方法安装其他 Python 包，只需替换包名即可。
🔗 参考资料
-
PyInstaller 官网
-
PyPI 官方镜像
-
清华大学 PyPI 镜像
附件：已打包好的离线安装包
PyInstaller 离线安装包
笔记记录