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 操作系统要求
    • 1.2 必要依赖与工具
  2. Python 3.5 (64位) 安装步骤
    • 2.1 下载 Python 3.5 安装包
    • 2.2 执行安装程序
    • 2.3 验证 Python 安装
  3. PyInstaller 3.2 安装步骤
    • 3.1 使用 pip 安装 PyInstaller
    • 3.2 验证 PyInstaller 安装
  4. 测试环境:打包与运行示例程序
    • 4.1 创建测试脚本
    • 4.2 使用 PyInstaller 打包
    • 4.3 运行打包后的可执行文件
  5. 常见问题与解决方案
    • 5.1 Python 环境变量配置问题
    • 5.2 打包时缺少模块或依赖
    • 5.3 可执行文件运行时缺失 DLL
    • 5.4 杀毒软件误报问题
  6. 最佳实践
    • 6.1 使用虚拟环境隔离项目
    • 6.2 规范脚本路径与依赖管理
    • 6.3 测试打包结果的兼容性
  7. 总结
  8. 参考资料

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 已停止官方维护,但可通过历史版本页面获取安装包:

2.2 执行安装程序#

  1. 双击下载的 python-3.5.4-amd64.exe,勾选 Add Python 3.5 to PATH( critical!自动配置环境变量)。
    Python安装界面(示意图:勾选"Add Python to PATH")
  2. 点击 Customize installation(自定义安装),建议保留默认组件(pip 必须勾选,用于后续安装 PyInstaller)。
  3. 点击 Next,选择安装路径(建议默认路径 C:\Python35,避免中文或空格路径),点击 Install 开始安装。
  4. 安装完成后,点击 Close。

2.3 验证 Python 安装#

  1. 打开 命令提示符(管理员)(Win+R → 输入 cmd → 按 Ctrl+Shift+Enter)。
  2. 执行以下命令验证版本:
    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。

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 打包#

  1. 打开命令提示符,进入脚本所在目录(例如 cd D:\test)。

  2. 执行打包命令:

    pyinstaller --onefile --windowed test_app.py
    • --onefile:将所有依赖打包为单个可执行文件(dist\test_app.exe)。
    • --windowed:隐藏控制台窗口(适用于 GUI 程序;若为控制台程序,去掉此参数)。
  3. 打包过程输出日志,若成功,会显示 INFO: Building EXE from out00-EXE.toc completed successfully.。

  4. 生成的文件结构:

    test_app/
    ├─ build/          # 临时构建文件(可删除)
    ├─ dist/           # 最终输出目录,包含 test_app.exe
    └─ test_app.spec   # 打包配置文件(可用于自定义打包参数)
    

4.3 运行打包后的可执行文件#

  1. 进入 dist 目录,双击 test_app.exe。
  2. 预期效果:
    • 弹出 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#

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 的安装、配置及测试流程。通过遵循步骤,可快速搭建环境并验证打包功能。实际应用中,需注意依赖管理、路径规范及兼容性测试,以确保打包后的程序在目标环境中稳定运行。

8. 参考资料#