pyinstaller参数及功能
194 2025-03-18 09:59
PyInstaller 是一个用于将 Python 程序及其依赖打包为独立可执行文件的工具,支持 Windows、macOS 和 Linux 平台。以下是 PyInstaller 的常用参数及其功能说明:
常用参数
参数 | 功能 |
---|---|
-F 或 --onefile |
将程序打包为一个单独的可执行文件。 |
-D 或 --onedir |
将程序打包为一个文件夹,其中包含可执行文件和依赖文件(默认模式)。 |
--add-data <SRC;DEST or SRC:DEST> |
添加非二进制文件或文件夹到打包的应用程序中,路径分隔符为 ; (Windows)或 : (Unix)。 |
--add-binary <SRC;DEST or SRC:DEST> |
添加二进制文件到打包的应用程序中。 |
-p DIR 或 --paths DIR |
设置额外的模块搜索路径,类似于设置 PYTHONPATH 。 |
--hidden-import MODULENAME |
指定在代码中未显式导入但需要的模块。 |
-w 或 --windowed |
不显示控制台窗口(仅适用于 Windows 和 macOS)。 |
-c 或 --console |
显示控制台窗口(默认行为)。 |
-i <FILE> 或 --icon <FILE> |
设置可执行文件的图标(Windows 使用 .ico 文件,macOS 使用 .icns 文件)。 |
--version-file FILE |
将版本资源文件嵌入到 Windows 可执行文件中。 |
--upx-dir UPX_DIR |
指定 UPX 压缩工具的路径。 |
--noupx |
禁用 UPX 压缩。 |
特殊功能
- 启动画面:通过
--splash IMAGE_FILE
添加启动画面。 - 调试模式:使用
-d
或--debug
参数可以启用调试模式,帮助诊断问题。 - 排除模块:通过
--exclude-module EXCLUDES
排除不需要的模块。 - 运行时钩子:使用
--runtime-hook RUNTIME_HOOKS
添加自定义运行时钩子。
其他选项
--clean
:清理 PyInstaller 缓存和临时文件。--log-level LEVEL
:设置构建时的日志级别(如INFO
、DEBUG
等)。--distpath DIR
:指定打包后的输出目录。
PyInstaller 的功能主要体现在以下几个方面:
- 独立打包:将 Python 程序及其依赖打包为独立的可执行文件,无需安装 Python 解释器。
- 跨平台支持:支持 Windows、macOS 和 Linux,但不能跨平台编译。
- 灵活的打包模式:支持单文件模式和文件夹模式。
- 自定义功能:通过参数和钩子文件实现高度定制。
更多详细信息可以参考 PyInstaller 的官方文档。
全部评论