当前位置：网站首页 > 技术资源 > 正文

Python一键打包为windows的exe文件，无需安装python环境即可执行

off999 2025-05-14 15:50 23 浏览 0 评论

一、为什么要将Python打包为 exe？

在实际应用中，我们希望Python程序能在没有安装Python环境的电脑上直接运行。将Python代码打包为exe可执行文件，不仅能解决环境依赖问题，还便于程序的分发和部署。

二、常用打包工具及核心函数介绍

1. pyinstaller

pyton程序版本需要Python <3.14, >=3.8。

安装：pip install pyinstaller -i
https://mirrors.aliyun.com/pypi/simple/

打包：pyinstaller [options] script.py

[options]为打包选项，script.py为打包的Python脚本。

-F：打包成单个可执行文件（推荐使用，方便文件分发）。
-w：窗口化模式，隐藏命令行窗口（适用于图形界面程序）。
-i：指定程序图标（格式如.ico）。

案例：

# 打包成单个可执行文件
pyinstaller -F hello.py
# 打包图形界面程序，隐藏命令行窗口并指定图标
pyinstaller -F -w -i icon.ico gui_app.py

当然还有其他一些参数，参见附录中的介绍。

2. cx_Freeze

python版本需要Python >=3.9。

安装：pip install cx_Freeze -i
https://mirrors.aliyun.com/pypi/simple/

打包：需要在项目目录下创建setup.py文件进行配置，然后在命令行执行python setup.py build进行打包，最后在build目录下生成可执行exe文件。

from cx_Freeze import setup, Executable
setup(
name="MyApp",
version="1.0",
description="My Python application",
executables=[Executable("main.py")]
)

3. py2exe

py2exe用于Windows平台，适配python版本：Python < 3.12, >=3.8

安装：pip install py2exe -i
https://mirrors.aliyun.com/pypi/simple/

打包：需要在项目目录下创建setup.py文件进行配置，然后在命令行执行python setup.py py2exe进行打包，最后在当前目录下生成可执行exe文件。

from distutils.core import setup
import py2exe
setup(
console=["main.py"]
)

三、实用案例详解

我们将之前文章介绍的使用pywebio做数学题的web程序打包为一个exe可执行文件。（文章：Python中PyWebIO：无须搞懂前端知识，也能5分钟快速搭建Web应用）

我们新建一个pywebio-math.py文件，放入程序

from pywebio.pin import put_input, pin, pin_wait_change
from pywebio.output import *
from pywebio.input import *
import random
from pywebio.session import hold


class calcMath:

    def __init__(self, num):
        self.num = num  # 题目的数量
        self.finish_switch = False  # 答案提交后 置为True

    def mathproblem(self):
        """
        根据题目的数量，生成100以内的的加减混合运算的数学题的字典并返回；
        字典的key是题目，value是答案
        """
        math_problem = {}
        num = 1
        while num <= self.num:
            num1 = random.randint(1, 99)
            num2 = random.randint(1, 99)
            num3 = random.randint(1, 99)
            if num1 + num2 - num3 < 100 and num1 + num2 - num3 > 0 and num1 + num2 < 100:
                num += 1
                result = num1 + num2 - num3
                key_name = f'{num1} + {num2} - {num3}'
                math_problem[key_name] = result
        return math_problem

    def submit_result(self):
        # 弹出对话框  是否确认提交  点击提交会触发生成答案信息
        popup('确定提交吗？', [
            put_buttons(['确定'], onclick=lambda _: self.set_witch()),
            put_buttons(['取消'], onclick=lambda _: close_popup())
        ])

    def set_witch(self):
        self.finish_switch = True
        try:
            close_popup()
        except Exception as e:
            print(e)

        if self.finish_switch:
            # 生成答案信息 并输出
            self.analyse_result(inputs_str, origin_answer_result, new_answer_result)
            self.finish_switch = False

    def analyse_result(self, inputs_str, origin_answer_result, new_answer_result):

        """
        分析答案
        :param inputs_str: 包含题目信息的列表
        :param origin_answer_result:  真实答案
        :param new_answer_result:     答题的答案
        : return:
        """

        rightnum = 0  # 做对的题目数
        for num in range(len(inputs_str)):
            # 判断输入为空或者不为数字时，认为题目做错了
            if not new_answer_result[num] or not str(new_answer_result[num]).isdigit():
                put_text(
                    f'这个题 {inputs_str[num]} 做错了, 提交的答案是{new_answer_result[num]} ,正确答案是{origin_answer_result[num]}')
            else:
                # 当真实答案和做出的答案一致时，数字加1
                if int(origin_answer_result[num]) == int(new_answer_result[num]):
                    rightnum += 1
                else:
                    put_text(
                        f'这个题 {inputs_str[num]} 做错了, 提交的答案是{new_answer_result[num]} ,正确答案是{origin_answer_result[num]}')
        # 汇总最后的结果输出到web页面上
        put_text(f'--总共{len(inputs_str)}，做对了{rightnum}题，做错了{len(inputs_str) - rightnum}题')

    def start_do_math(self):
        """
        执行函数
        :return:
        """
        # 生成数学题字典 key是题目，value是答案
        mathdict = self.mathproblem()

        # 生成pywebio的input函数用到的输入数学题信息列表： 展示的是题目信息
        inputs_str = [f'{key} = ( )' for key in mathdict.keys()]

        # 生成对应的答案列表 用于跟答题时写的答案做对比
        origin_answer_result = [mathdict[key] for key in mathdict.keys()]

        # 调用pywebio的pin.put_input函数 和pin_wait_change 监听输入的答案 输入后进行下一个题目
        keys = [f'num{i + 1}' for i in range(self.num)]
        for i in range(self.num):
            put_input(keys[i], label=f'第{i + 1}题 请在下方输入答案（输入后不支持修改）\n {inputs_str[i]}')
            pin_wait_change(keys[i], timeout=1000)  # 监听输入 有输入后才进行下一次循环

        # 提交按钮  点击后弹出确认对话框
        put_button('submit', onclick=self.submit_result)
        # 提取提交的答案
        new_answer_result = [getattr(pin, key) for key in keys]
        # print(new_answer_result)
        return inputs_str, origin_answer_result, new_answer_result


num = input('请输入题目的数量：',type=NUMBER)
math1 = calcMath(num)  #实例化
inputs_str, origin_answer_result, new_answer_result = math1.start_do_math()
#保持会话 直到关闭浏览器
hold()

然后我们使用上述介绍的方法，打包为一个exe文件，打包后我们双击exe文件，执行效果跟通过python执行是一样的。

我们使用cx_Freeze进行打包，在程序目录中见一个setup.py文件，然后填入参数

from cx_Freeze import setup, Executable
setup(
    name="MyApp",
    version="1.0",
    description="My Python application",
    executables=[Executable("pywebio-math.py")]
)

目录内容如下：

然后再命令行执行：

最后在build目录生成一个exe文件

我们双击pywebio-math.exe然后执行。

四、附录

pyinstaller的其他一些参数介绍：

1. -p, --paths 添加额外的模块搜索路径。当你的程序依赖的模块不在默认搜索路径中时，可通过该参数指定路径，让PyInstaller找到相关模块。

pyinstaller -F -p ./my_lib script.py

这样PyInstaller在打包时就会到./my_lib路径下查找所需模块。

2. --add-data 将非 Python 文件（如图片、配置文件等）添加到打包结果中。在 Windows 系统中，参数格式为source;dest；在 Linux 和 macOS 系统中，参数格式为source:dest。其中source是源文件或目录路径，dest是打包后文件在可执行文件中的存放路径。