当前位置:首页 > Python > 正文

用cx_Freeze将Python程序打包成exe(小白也能学会的cx_Freeze打包Python程序详细教程)

在开发完一个Python程序后,你是否希望把它分享给没有安装Python环境的朋友?这时候就需要把.py文件打包成独立的可执行文件(如Windows下的.exe)。cx_Freeze 是一个免费、开源且跨平台的Python转exe工具,支持 Windows、macOS 和 Linux。本教程将手把手教你如何使用 cx_Freeze 打包你的 Python 程序,即使你是编程小白也能轻松上手!

一、为什么选择 cx_Freeze?

相比 PyInstaller 或 py2exe,cx_Freeze 的优势在于:

  • 完全免费且开源(MIT 许可)
  • 支持 Python 3.6 及以上版本
  • 跨平台:同一套配置可在 Windows、macOS、Linux 上使用
  • 依赖少,安装简单
用cx_Freeze将Python程序打包成exe(小白也能学会的cx_Freeze打包Python程序详细教程) cx_Freeze打包Python程序 cx_Freeze教程 Python转exe工具 cx_Freeze使用指南 第1张

二、安装 cx_Freeze

首先确保你已安装 Python(建议 3.7+),然后打开命令提示符(Windows)或终端(macOS/Linux),运行以下命令:

pip install cx_Freeze

安装完成后,你可以通过以下命令验证是否安装成功:

cxfreeze --version

三、准备你的 Python 程序

假设你有一个简单的 Python 脚本 hello.py,内容如下:

print("欢迎使用 cx_Freeze 打包工具!")input("按回车键退出...")

四、创建 setup.py 配置文件

cx_Freeze 使用一个名为 setup.py 的文件来配置打包参数。在你的项目根目录下新建一个 setup.py 文件,内容如下:

from cx_Freeze import setup, Executable# 配置选项build_exe_options = {    "packages": [],          # 需要额外包含的包(如 requests, numpy 等)    "excludes": [],          # 排除不需要的模块    "include_files": []      # 额外包含的文件(如图片、配置文件等)}# 创建可执行文件配置exe = Executable(    script="hello.py",       # 主程序入口文件    base=None                # Windows 下若为 GUI 程序可设为 "Win32GUI")# 打包设置setup(    name="HelloApp",    version="1.0",    description="我的第一个 cx_Freeze 打包程序",    options={"build_exe": build_exe_options},    executables=[exe])

如果你的程序使用了第三方库(比如 requeststkinter),记得在 "packages" 列表中添加它们,例如:

"packages": ["requests", "tkinter"]

五、开始打包

在终端中进入你的项目目录(确保 hello.pysetup.py 在同一目录),运行以下命令:

python setup.py build

打包完成后,你会在项目目录下看到一个 build 文件夹,里面包含一个子文件夹(如 exe.win-amd64-3.9),你的可执行文件 hello.exe 就在里面。

六、常见问题与优化建议

  • 文件太大? cx_Freeze 默认会打包整个 Python 环境,你可以通过 excludes 排除不需要的模块来减小体积。
  • 缺少依赖? 如果程序运行报错“ModuleNotFoundError”,请检查 packages 是否包含了所有用到的第三方库。
  • 想生成单个 exe 文件? cx_Freeze 默认生成的是文件夹形式(包含多个 dll 和 pyd 文件),目前不支持单文件打包。如需单文件,可考虑 PyInstaller。

七、总结

通过本教程,你已经掌握了如何使用 cx_Freeze打包Python程序 的基本流程。无论你是开发命令行工具还是图形界面应用,cx_Freeze 都是一个稳定可靠的选择。记住关键步骤:安装 cx_Freeze → 编写 setup.py → 运行 build 命令。希望这篇 cx_Freeze使用指南 能帮助你顺利将 Python 项目分发给更多用户!

关键词回顾:cx_Freeze打包Python程序cx_Freeze教程Python转exe工具cx_Freeze使用指南