PyFuze完全指南如何将Python项目打包成跨平台单文件可执行程序【免费下载链接】pyfuzePackage Python projects into executables项目地址: https://gitcode.com/gh_mirrors/py/pyfuzePyFuze是一个强大的Python项目打包工具能够将复杂的Python应用程序转换为单个可执行文件实现真正的一次打包随处运行。无论你是开发者想要分发自己的应用还是普通用户需要将Python脚本转换为独立程序PyFuze都能提供简单高效的解决方案。 什么是PyFuzePyFuze是一个基于Cosmopolitan和uv构建的Python打包工具它能够将你的Python项目包括所有依赖项和Python解释器打包成一个独立的可执行文件。这个工具解决了Python应用分发的核心痛点——环境配置复杂、依赖管理困难等问题。三大打包模式对比PyFuze提供了三种不同的打包模式满足不同场景的需求模式离线运行跨平台支持文件大小兼容性最佳适用场景Bundle模式(默认)✅ 支持❌ 不支持 较大 最高需要最高兼容性的桌面应用Online模式❌ 需要网络✅ 支持 最小 高网络环境良好的Web应用Portable模式✅ 支持✅ 支持 中等 较低纯Python脚本的快速分发 快速开始安装与使用一键安装PyFuzepip 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_MIRRORPython镜像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]) 实战案例案例1GUI应用打包对于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_URLhttps://mirrors.aliyun.com/uv/ --env UV_PYTHON_INSTALL_MIRRORhttps://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），仅供参考
PyFuze完全指南：如何将Python项目打包成跨平台单文件可执行程序
PyFuze完全指南如何将Python项目打包成跨平台单文件可执行程序【免费下载链接】pyfuzePackage Python projects into executables项目地址: https://gitcode.com/gh_mirrors/py/pyfuzePyFuze是一个强大的Python项目打包工具能够将复杂的Python应用程序转换为单个可执行文件实现真正的一次打包随处运行。无论你是开发者想要分发自己的应用还是普通用户需要将Python脚本转换为独立程序PyFuze都能提供简单高效的解决方案。 什么是PyFuzePyFuze是一个基于Cosmopolitan和uv构建的Python打包工具它能够将你的Python项目包括所有依赖项和Python解释器打包成一个独立的可执行文件。这个工具解决了Python应用分发的核心痛点——环境配置复杂、依赖管理困难等问题。三大打包模式对比PyFuze提供了三种不同的打包模式满足不同场景的需求模式离线运行跨平台支持文件大小兼容性最佳适用场景Bundle模式(默认)✅ 支持❌ 不支持 较大 最高需要最高兼容性的桌面应用Online模式❌ 需要网络✅ 支持 最小 高网络环境良好的Web应用Portable模式✅ 支持✅ 支持 中等 较低纯Python脚本的快速分发 快速开始安装与使用一键安装PyFuzepip 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_MIRRORPython镜像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]) 实战案例案例1GUI应用打包对于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_URLhttps://mirrors.aliyun.com/uv/ --env UV_PYTHON_INSTALL_MIRRORhttps://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），仅供参考
