PyFuze完全指南：如何将Python项目打包成跨平台单文件可执行程序
【免费下载链接】pyfuzePackage Python projects into executables项目地址: https://gitcode.com/gh_mirrors/py/pyfuze
PyFuze是一个强大的Python项目打包工具，能够将复杂的Python应用程序转换为单个可执行文件，实现真正的"一次打包，随处运行"。无论你是开发者想要分发自己的应用，还是普通用户需要将Python脚本转换为独立程序，PyFuze都能提供简单高效的解决方案。
📦 什么是PyFuze？
PyFuze是一个基于Cosmopolitan和uv构建的Python打包工具，它能够将你的Python项目（包括所有依赖项和Python解释器）打包成一个独立的可执行文件。这个工具解决了Python应用分发的核心痛点——环境配置复杂、依赖管理困难等问题。
三大打包模式对比
PyFuze提供了三种不同的打包模式，满足不同场景的需求：
| 模式 | 离线运行 | 跨平台支持 | 文件大小 | 兼容性 | 最佳适用场景 |
|---|---|---|---|---|---|
| Bundle模式(默认) | ✅ 支持 | ❌ 不支持 | 🔴 较大 | 🟢 最高 | 需要最高兼容性的桌面应用 |
| Online模式 | ❌ 需要网络 | ✅ 支持 | 🟢 最小 | 🟢 高 | 网络环境良好的Web应用 |
| Portable模式 | ✅ 支持 | ✅ 支持 | 🟡 中等 | 🔴 较低 | 纯Python脚本的快速分发 |
🚀 快速开始：安装与使用
一键安装PyFuze
pip install pyfuze或者使用uvx直接运行：
uvx pyfuze -h简单示例：打包单文件脚本
假设你有一个简单的Python脚本simple.py，只需要一行命令：
pyfuze ./examples/simple.py --mode portable --reqs requests这条命令会生成一个名为simple.com的可执行文件，包含了requests依赖库，可以在Windows、Linux和macOS上直接运行！
🔧 高级功能详解
1. Bundle模式：完整离线包
Bundle模式是最常用的打包方式，它将Python解释器和所有依赖项都打包进可执行文件中：
pyfuze ./examples/complex \ --entry app.py \ --pyproject ./examples/complex/pyproject.toml \ --uv-lock ./examples/complex/uv.lock \ --include ./examples/complex/config.txt \ --exclude ./examples/complex/build.py \ --unzip-path complex \ --win-gui关键参数说明：
--entry: 指定入口文件（默认为main.py）--pyproject: 包含项目依赖配置--uv-lock: 锁定依赖版本--include: 包含额外文件（如配置文件）--exclude: 排除不需要的文件--win-gui: 隐藏Windows控制台窗口
2. Online模式：轻量级跨平台
Online模式生成的文件最小，运行时自动下载依赖：
pyfuze ./examples/complex \ --mode online \ --uv-install-script-windows <镜像URL> \ --env UV_PYTHON_INSTALL_MIRROR=<Python镜像>3. Portable模式：纯Python跨平台
Portable模式最适合简单的Python脚本，基于python.com构建：
pyfuze ./examples/simple.py --mode portable🎯 核心优势与特点
🌍 真正的跨平台支持
PyFuze利用Cosmopolitan的APE格式，生成的可执行文件可以在多个操作系统上运行：
- macOS(ARM64和AMD64)
- Linux(AMD64)
- Windows(AMD64)
📁 灵活的文件管理
PyFuze提供了强大的文件管理功能：
# 包含额外文件 --include config.ini::config/ --include data.json # 排除特定文件 --exclude test.py --exclude build/🔧 环境变量配置
通过环境变量控制运行时行为：
import os # 切换到可执行文件所在目录 os.chdir(os.path.dirname(os.environ["PYFUZE_EXECUTABLE_PATH"])) # 切换到用户调用目录 os.chdir(os.environ["PYFUZE_INVOKE_DIR"])📝 实战案例
案例1：GUI应用打包
对于GUI应用，使用--win-gui参数隐藏控制台窗口：
pyfuze my_gui_app --entry gui_main.py --win-gui案例2：带配置文件的Web应用
pyfuze web_app \ --entry app.py \ --include config.yaml \ --include static/ \ --exclude tests/ \ --mode bundle案例3：跨平台命令行工具
pyfuze cli_tool --mode portable --output-name mytool.com⚠️ 注意事项与最佳实践
工作目录设置
默认工作目录是<unzip-path>/src，你可以通过环境变量调整：
# 在Python代码中获取运行时信息 import os print(f"可执行文件路径: {os.environ.get('PYFUZE_EXECUTABLE_PATH')}") print(f"调用目录: {os.environ.get('PYFUZE_INVOKE_DIR')}")镜像配置建议
在国内网络环境下，建议配置镜像加速：
--env INSTALLER_DOWNLOAD_URL=https://mirrors.aliyun.com/uv/ --env UV_PYTHON_INSTALL_MIRROR=https://mirrors.aliyun.com/pypi/simple/安全提醒
PyFuze不提供代码加密或混淆功能。打包后的可执行文件可以通过解压查看源代码。
🔍 常见问题解答
Q: PyFuze支持哪些Python版本？
A: Portable模式固定使用Python 3.12.3，其他模式支持通过.python-version文件指定版本。
Q: 打包后的文件可以在哪些系统运行？
A: 支持macOS、Linux、Windows的64位系统，具体取决于打包模式。
Q: 如何调试打包过程？
A: 使用-d或--debug参数启用调试日志。
Q: 可以打包包含C扩展的Python包吗？
A: Bundle模式支持，Portable模式仅支持纯Python包。
🛠️ 项目结构参考
了解PyFuze的项目结构有助于更好地使用它：
pyfuze/ ├── src/pyfuze/ # 核心源代码 │ ├── cli.py # 命令行接口 │ ├── utils.py # 工具函数 │ └── __main__.py # 入口点 ├── examples/ # 示例项目 │ ├── simple.py # 简单示例 │ └── complex/ # 复杂示例 ├── csrc/ # C语言源代码 │ └── main.c # 主程序逻辑 └── pyproject.toml # 项目配置🎉 开始你的PyFuze之旅
PyFuze让Python应用分发变得前所未有的简单。无论你是要创建跨平台的桌面应用、分发命令行工具，还是打包Web应用后端，PyFuze都能提供合适的解决方案。
立即尝试，体验一键打包的便捷：
# 安装PyFuze pip install pyfuze # 打包你的第一个Python应用 pyfuze your_script.py --mode portable记住：好的工具让开发更高效，PyFuze正是这样的工具！🚀
【免费下载链接】pyfuzePackage Python projects into executables项目地址: https://gitcode.com/gh_mirrors/py/pyfuze
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
