Python 离线安装 PyInstaller 的完整步骤(以 Python 3.11.4-amd64.exe 为例)
PyInstaller 是一个将 Python 脚本打包为独立可执行文件的工具。离线安装适用于没有互联网连接的环境,需要预先下载所有依赖文件。以下步骤以 Windows 系统为例(Python 版本为 3.11.4-amd64),结构清晰,确保可靠。整个过程分为两个阶段:在有网环境中下载文件,然后在离线环境中安装。
阶段 1: 在有网环境中下载 PyInstaller 及其依赖
在这一阶段,您需要一台有互联网连接的计算机(已安装 Python 3.11.4),用于下载 PyInstaller 及其所有依赖包。下载的文件将保存到一个目录中,以便复制到离线机器。
-
安装 Python 3.11.4(如果尚未安装):
-
从 Python 官网下载
python-3.11.4-amd64.exe安装程序。 -
运行安装程序,选择"Add Python to PATH"选项,完成安装。
-
验证安装:打开命令提示符(CMD),输入:
bashpython --version应显示
Python 3.11.4。
-
-
下载 PyInstaller 及其依赖:
-
打开命令提示符(CMD)。
-
使用
pip download命令下载 PyInstaller 和其依赖包。指定一个目录(如C:\pyinstaller_downloads)保存文件:bashpip download pyinstaller -d C:\pyinstaller_downloads- 此命令会自动下载 PyInstaller 及其所有依赖(如 pywin32、pefile、altgraph 等)。
- 确保 pip 已更新:如果提示 pip 版本旧,先运行
python -m pip install --upgrade pip。
-
验证下载:检查目录
C:\pyinstaller_downloads,应包含多个.whl文件(wheel 包)或源码文件。
-
-
复制文件到离线环境:
- 将整个
C:\pyinstaller_downloads目录复制到 U 盘或其他存储设备。 - 传输到目标离线机器。
- 将整个
阶段 2: 在离线环境中安装 PyInstaller
在这一阶段,您在离线计算机上安装 Python(如果尚未安装),然后使用下载的文件安装 PyInstaller。
-
安装 Python 3.11.4(如果尚未安装):
- 复制
python-3.11.4-amd64.exe到离线机器。 - 运行安装程序,同样选择"Add Python to PATH"。
- 验证安装:打开命令提示符,输入
python --version。
- 复制
-
安装 PyInstaller 及其依赖:
-
将下载文件目录(如
C:\pyinstaller_downloads)复制到离线机器的本地路径(例如D:\offline_packages)。 -
打开命令提示符。
-
使用
pip install命令指定本地目录安装:bashpip install --no-index --find-links=D:\offline_packages pyinstaller--no-index忽略网络源。--find-links指定本地文件路径。
-
验证安装:
bashpyinstaller --version应显示 PyInstaller 版本号(如
6.0.0)。
-
注意事项
-
依赖兼容性:PyInstaller 依赖包版本需兼容 Python 3.11.4。下载时,pip 会自动选择合适版本。如果安装失败,检查下载目录是否包含所有必要文件。
-
路径问题 :Windows 路径使用反斜杠(如
C:\path)。确保命令提示符以管理员权限运行,避免权限错误。 -
测试打包 :安装完成后,测试 PyInstaller:
bashpyinstaller --onefile your_script.py # 打包一个示例脚本 -
其他系统 :本步骤针对 Windows。对于 Linux 或 macOS,方法类似,但路径和命令需调整(如使用
/path/to/files)。
通过以上步骤,您可以成功在离线环境中安装 PyInstaller,并开始打包 Python 应用。