Win7(64位) + Python3.5 + PyInstaller3.2 环境搭建与测试全指南
在部分 legacy 系统或特定项目中,仍需依赖 Python 3.5 版本及配套的 PyInstaller 3.2 进行应用打包。本文将详细介绍在 Windows 7 64位系统下,如何一步步搭建 Python 3.5 环境,并安装 PyInstaller 3.2 工具,最终通过实例验证打包功能。无论是新手还是需要维护旧项目的开发者,都能通过本文快速掌握环境配置与测试流程。
目录#
- 前提条件
- 1.1 操作系统要求
- 1.2 必要依赖与工具
- Python 3.5 (64位) 安装步骤
- 2.1 下载 Python 3.5 安装包
- 2.2 执行安装程序
- 2.3 验证 Python 安装
- PyInstaller 3.2 安装步骤
- 3.1 使用 pip 安装 PyInstaller
- 3.2 验证 PyInstaller 安装
- 测试环境:打包与运行示例程序
- 4.1 创建测试脚本
- 4.2 使用 PyInstaller 打包
- 4.3 运行打包后的可执行文件
- 常见问题与解决方案
- 5.1 Python 环境变量配置问题
- 5.2 打包时缺少模块或依赖
- 5.3 可执行文件运行时缺失 DLL
- 5.4 杀毒软件误报问题
- 最佳实践
- 6.1 使用虚拟环境隔离项目
- 6.2 规范脚本路径与依赖管理
- 6.3 测试打包结果的兼容性
- 总结
- 参考资料
1. 前提条件#
1.1 操作系统要求#
- 系统版本:Windows 7 旗舰版/企业版/专业版(64位),已安装 Service Pack 1 (SP1)。
- 硬件要求:至少 2GB 内存,10GB 可用磁盘空间。
- 权限:需拥有管理员权限(安装软件时需要)。
1.2 必要依赖与工具#
- Visual C++ Redistributable for Visual Studio 2015:Python 3.5 基于 VS2015 编译,需安装此运行时库。
下载地址:Microsoft 官方下载(选择vc_redist.x64.exe)。 - 网络连接:用于下载 Python 安装包和 PyInstaller。
2. Python 3.5 (64位) 安装步骤#
2.1 下载 Python 3.5 安装包#
Python 3.5 已停止官方维护,但可通过历史版本页面获取安装包:
- 下载地址:Python 3.5.4 64位安装包(3.5 系列最后一个稳定版)。
- 验证文件完整性:建议通过 SHA256 校验和确认安装包未被篡改(官方校验和页面)。
2.2 执行安装程序#
- 双击下载的
python-3.5.4-amd64.exe,勾选 Add Python 3.5 to PATH( critical!自动配置环境变量)。
(示意图:勾选"Add Python to PATH") - 点击 Customize installation(自定义安装),建议保留默认组件(
pip必须勾选,用于后续安装 PyInstaller)。 - 点击 Next,选择安装路径(建议默认路径
C:\Python35,避免中文或空格路径),点击 Install 开始安装。 - 安装完成后,点击 Close。
2.3 验证 Python 安装#
- 打开 命令提示符(管理员)(Win+R → 输入
cmd→ 按 Ctrl+Shift+Enter)。 - 执行以下命令验证版本:
若提示python --version # 输出:Python 3.5.4 pip --version # 输出:pip 9.0.1 from c:\python35\lib\site-packages (python 3.5)python 不是内部或外部命令,需手动配置环境变量:- 右键 计算机 → 属性 → 高级系统设置 → 环境变量 → 编辑 Path → 添加
C:\Python35和C:\Python35\Scripts。
- 右键 计算机 → 属性 → 高级系统设置 → 环境变量 → 编辑 Path → 添加
3. PyInstaller 3.2 安装步骤#
3.1 使用 pip 安装 PyInstaller#
PyInstaller 3.2 是与 Python 3.5 兼容的稳定版本,通过 pip 安装:
pip install pyinstaller==3.2- 若网络缓慢,可使用国内镜像源(如豆瓣):
pip install -i https://pypi.doubanio.com/simple/ pyinstaller==3.2
3.2 验证 PyInstaller 安装#
执行以下命令确认版本:
pyinstaller --version # 输出:3.2若提示 pyinstaller 不是内部或外部命令,检查 C:\Python35\Scripts 是否在 Path 环境变量中(参考 2.3 节)。
4. 测试环境:打包与运行示例程序#
4.1 创建测试脚本#
创建一个简单的 Python 脚本(例如 test_app.py),包含控制台输出和 GUI 界面(使用 Tkinter,Python 3.5 内置):
# test_app.py
import tkinter as tk
from tkinter import messagebox
import os
def main():
# 控制台输出
print("测试程序启动...")
# GUI界面
root = tk.Tk()
root.title("PyInstaller测试")
root.geometry("300x200")
label = tk.Label(root, text="Hello, Win7 + Python3.5 + PyInstaller3.2!")
label.pack(pady=20)
def show_msg():
messagebox.showinfo("提示", "打包成功!")
btn = tk.Button(root, text="点击测试", command=show_msg)
btn.pack()
root.mainloop()
if __name__ == "__main__":
main()4.2 使用 PyInstaller 打包#
-
打开命令提示符,进入脚本所在目录(例如
cd D:\test)。 -
执行打包命令:
pyinstaller --onefile --windowed test_app.py--onefile:将所有依赖打包为单个可执行文件(dist\test_app.exe)。--windowed:隐藏控制台窗口(适用于 GUI 程序;若为控制台程序,去掉此参数)。
-
打包过程输出日志,若成功,会显示
INFO: Building EXE from out00-EXE.toc completed successfully.。 -
生成的文件结构:
test_app/ ├─ build/ # 临时构建文件(可删除) ├─ dist/ # 最终输出目录,包含 test_app.exe └─ test_app.spec # 打包配置文件(可用于自定义打包参数)
4.3 运行打包后的可执行文件#
- 进入
dist目录,双击test_app.exe。 - 预期效果:
- 弹出 GUI 窗口,显示标签和按钮。
- 点击按钮,弹出 "打包成功!" 提示框。
- (若未使用
--windowed)控制台会输出 "测试程序启动..."。
5. 常见问题与解决方案#
5.1 Python 环境变量配置问题#
- 症状:
python或pip命令未找到。 - 解决:手动添加 Python 路径到环境变量(见 2.3 节),或重新安装并勾选 "Add Python to PATH"。
5.2 打包时缺少模块或依赖#
- 症状:打包成功,但运行
exe时提示ModuleNotFoundError: No module named 'xxx'。 - 解决:使用
--hidden-import显式指定缺失模块,例如:pyinstaller --onefile --windowed --hidden-import=requests test_app.py # 假设缺少 requests 模块
5.3 可执行文件运行时缺失 DLL#
- 症状:运行
exe时提示无法启动此程序,因为计算机中丢失 xxx.dll(如api-ms-win-crt-runtime-l1-1-0.dll)。 - 解决:安装 Visual C++ Redistributable for Visual Studio 2015(见 1.2 节)。
5.4 杀毒软件误报问题#
- 症状:打包的
exe被杀毒软件隔离或删除。 - 解决:将
dist目录添加到杀毒软件白名单,或暂时关闭实时防护后测试。
6. 最佳实践#
6.1 使用虚拟环境隔离项目#
Python 3.5 内置 venv 模块,可创建独立环境避免依赖冲突:
python -m venv myenv # 创建虚拟环境
myenv\Scripts\activate # 激活环境(命令提示符中)
pip install pyinstaller==3.2 # 在虚拟环境中安装依赖6.2 规范脚本路径与依赖管理#
- 避免硬编码路径:使用
os.path处理文件路径,例如:data_path = os.path.join(os.path.dirname(__file__), "data.txt") # 相对路径 - 维护依赖清单:通过
pip freeze > requirements.txt生成依赖列表,方便他人复现环境:pip install -r requirements.txt # 安装依赖
6.3 测试打包结果的兼容性#
- 在 干净的 Win7 64位 虚拟机 中测试
exe,确保无缺失依赖(例如未安装 Python 或 VS 运行时的环境)。 - 测试不同用户权限(普通用户/管理员)下的运行情况。
7. 总结#
本文详细介绍了 Win7 64位 系统下 Python 3.5 与 PyInstaller 3.2 的安装、配置及测试流程。通过遵循步骤,可快速搭建环境并验证打包功能。实际应用中,需注意依赖管理、路径规范及兼容性测试,以确保打包后的程序在目标环境中稳定运行。