| 基本选项 |
|
|
|
--help |
无参数 |
- |
显示帮助信息并退出 |
--version |
无参数 |
关闭 |
显示版本信息及错误报告所需细节后退出 |
--mode=COMPILATION_MODE |
枚举值 |
accelerated |
编译模式:"accelerated"(依赖当前Python环境)、"standalone"(独立文件夹)、"onefile"(单文件自解压)、"app"(macOS应用包)等 |
--python-flag=FLAG |
字符串 |
空 |
指定Python标志(如"-S"、"no_asserts"等) |
--python-debug |
无参数 |
同当前环境 |
使用调试版Python(仅限测试) |
--main=PATH |
路径 |
主模块位置 |
替换或补充主编译文件(支持多分发) |
| 模块包含控制 |
|
|
|
--include-package=PACKAGE |
包命名空间 |
空 |
包含整个包及其子模块 |
--include-module=MODULE |
模块命名空间 |
空 |
包含单个模块 |
--nofollow-imports |
无参数 |
关闭 |
禁止递归导入任何模块(独立模式不可用) |
--follow-stdlib |
无参数 |
关闭 |
递归导入标准库模块(可能增加编译时间) |
| 单文件模式 |
|
|
|
--onefile-tempdir-spec=SPEC |
路径模板 |
{TEMP}/... |
单文件解压目录 |
--onefile-no-compression |
无参数 |
关闭 |
禁用单文件压缩 |
--onefile-as-archive |
无参数 |
关闭 |
生成可手动解压的归档格式 |
| 数据文件 |
|
|
|
--include-package-data=PACKAGE[:PATTERN] |
包名+可选模式 |
空 |
包含包内非DLL数据文件(支持通配符) |
--include-data-files=SOURCE=TARGET |
源路径=目标路径 |
空 |
按文件路径包含数据(支持通配符和递归) |
--include-data-dir=DIRECTORY=TARGET |
源目录=目标目录 |
空 |
递归包含整个目录的数据文件 |
| 调试与输出 |
|
|
|
--run |
无参数 |
关闭 |
编译后立即执行生成的文件 |
--debug |
无参数 |
关闭 |
启用自检调试模式(非生产环境使用) |
--output-filename=FILENAME |
路径 |
<程序名>.exe |
指定输出可执行文件名 |
--remove-output |
无参数 |
关闭 |
编译后删除临时构建目录 |
| 高级编译 |
|
|
|
--jobs=N |
整数(可为负) |
CPU核心数 |
并行C编译任务数(负值表示系统CPU减N) |
--lto=choice |
yes/no/auto |
auto |
启用链接时优化(LTO) |
--clang |
无参数 |
关闭 |
强制使用Clang编译器 |
| 平台特定 |
|
|
|
--windows-console-mode=MODE |
force/disable/attach |
force |
Windows控制台模式(强制创建/禁用/附加现有) |
--macos-create-app-bundle |
无参数 |
关闭 |
macOS下生成应用包(.app) |
--macos-app-icon=ICON_PATH |
路径 |
Python图标 |
设置macOS应用图标 |
| 插件控制 |
|
|
|
--enable-plugins=PLUGIN_NAME |
插件名列表 |
空 |
启用指定插件 |
--disable-plugins=PLUGIN_NAME |
插件名列表 |
空 |
禁用指定插件 |
--plugin-list |
无参数 |
关闭 |
列出所有可用插件后退出 |