Nuitka Commander - 2.7.* (zh-CN)

是否在所有选项中显示原始命令

创建一个可导入的二进制拓展模块可执行文件，而不是程序。默认关闭。

启用独立模式进行输出。这允许你将二进制文件传输到其他机器, 而无需使用已有的Python环境。这也意味着它将变得很大它将启用这些选项: "--follow-imports" 和 "--python-flag=no_site"。

在独立模式的基础上, 启用单文件模式。这意味着不是一个文件夹, 而是创建和使用一个压缩的可执行文件。

是否使用调试版本。默认使用你运行Nuitka的版本，其很可能是一个非调试版本。仅用于调试和测试目的。

用于编译的模式

要使用的Python标志.默认是你用来运行Nuitka的内容, 这强制使用特定模式.这些也是标准Python可执行文件中存在的选项.

当使用Python 3.4编译时，提供一个Python二进制文件路径以供Scons使用。否则，Nuitka可以使用你运行Nuitka的Python，或者自行找到Nuitka安装，例如从Windows注册表中。在Windows上，需要Python 3.5或者更高版本，在非Windows上，Python 2.6或Python 2.7也可以。

如果只指定一次(如--main="1.py")，这将取代位置参数，也就是要编译的文件名(入口)。如果指定多次(如--main="1.py" --main="2.py"), 它将启用"multidist",它允许您创建依赖于文件名或调用名的二进制文件。 (允许多个主程序使用同一套编译参数)

对于已经编译的拓展模块，如果存在源代码和拓展模块，通常会使用拓展模块，但为了获得最佳的性能，最好从可用的源代码编译模块。如果不需要，可以使用--nop-prefer-source-code来禁用有关于此的警告。默认关闭。

包含整个包。以Python命名空间的形式给出，例如’some_package.sub_package’，然后Nuitka会找到它并包含它以及在其创建的二进制或扩展模块的磁盘位置下面找到的所有模块，并使其可以被代码导入。为了避免不需要的子包，例如测试，你可以这样做’–nofollow-import-to=*.tests’。默认为空。 (注: 这里的包含是指将包含的包或模块编译到二进制文件中并可以被代码导入, 而不是将其作为依赖项)

包含单个模块。以Python命名控件的形式给出，例如'some_package.some_module'，然后Nuitka会找到它并将其包含在其创建的二进制文件或扩展模块中，并使其可以被代码导入。默认为空

同时包括该目录中找到的代码，将它们视为各自的主文件。这将覆盖其他包含(include)选项。你应该更倾向于使用其他包含选项。它们是通过名称而不是文件名来查找的，这些选项可以通过在'sys.path'中找到东西这个选项只适用于非常特殊的用例。可以多次给出。默认为空。

包含匹配PATTERN(模式)的文件。覆盖所有其他的跟随选项。可以多次给出。默认为空

导入所有被导入的模块。在独立模式下默认开启，否则关闭

不递归深入(导入)到任何导入的模块，这将覆盖所有其他包含选项，并且不能用于独立模式。默认关闭。

也深入到从标准库导入的模块，这将大大增加编译时间，而且目前也没有很好的测试，有时候也可能不会工作。默认关闭。

如果使用了该模块，则跟随到该模块，或者如果是一个包，则跟随到整个包。可以多次给出。默认为空。

即使使用了该模块名称也不要跟随导入该模块，或者如果是一个包名称，无论如何都不要跟随导入整个包，该选项覆盖所有其他选项。这也可以包含模式，例如 "*.tests"。可以多次给出。默认为空。

在创建单文件时，禁用有效载荷的压缩。这主要是出于调试目的，或者为了节省时间。默认关闭

在创建onefile的时候，使用一个可以被"nuitka-onefile-unpack"解压的存档格式，而不是一个只有onefile程序本身才能解压的流。

在创建单文件时，某些平台（目前是 Windows，如果不使用缓存的位置的话）默认使用 DLL 而不是可执行文件来存储 Python 代码。启用此选项会使解压后的文件中也使用可执行文件而非 DLL。默认关闭。

这个模式是从你使用的规范中推断出来的。如果它包含运行时依赖的路径，"auto"会解析为"temporary"，这将确保在执行后删除解压的二进制文件，而"cached"则不会删除它，并在下次执行时重用其内容以获得更快的启动时间。

在单文件模式下，使用此作为解压的文件夹使用例如像'///'这样的字符串是一个很好的静态缓存路径，并且它将不会被删除。

当停止子进程时，例如由于CTRL-C或关闭等，Python代码会得到一个"KeyboardInterrupt"，它可能会处理例如刷新数据等事件。这是以硬方式杀死子进程之前的时间量。单位是毫秒，默认为5000。

包含给定包名的数据文件。DLL 和扩展模块不是数据文件，因此不会以这种方式包含。可以使用文件名模式，如下所示。默认情况下，包的数据文件不会被包含，但可以通过包配置来实现。这只会包含非 DLL、非扩展模块，即实际的数据文件。在 ":" 之后，可以选择性地提供一个文件名模式，以仅选择匹配的文件。示例："--include-package-data=package_name"（所有文件） "--include-package-data=package_name:*.txt"（仅特定类型）" --include-package-data=package_name:some_filename.dat"（具体文件）。默认为空

通过分配的文件名包含数据文件。有很多允许的形式。使用–include-data-files=/path/to/file/.txt=folder_name/some.txt’，它将复制一个文件，如果是十多个文件，将会报错。使用’–include-data-files=/path/to/files/.txt=folder_name/‘将把所有匹配的文件放入该文件夹。对于递归复制，有一种带有三个值的形式:’–include-data-files=/path/to/scan=folder_name=/**/*.txt’，这将保留目录的文件结构。默认为空。

将整个目录的数据文件包含在分发中。这是递归的。如果你想要非递归包含，请查看'--include-data-files'与模式。例如,’–include-data-dir=/path/some_dir=data/some_dir’，用于整个目录的普通复制。所有的非代码文件都会被包含，并且你也可以使用'--noinclude-data-files'选项来删除它们。默认为空

不包含与给定文件名形式匹配的数据文件。这是针对目标文件名而非源路径的。因此，要从'package_name'的包数据中忽略一个文件模式，应该匹配为"package_name/*.txt", 或者是对整个目录而简单地使用"package_name"。默认为空

将指定的数据文件模式包含在单文件二进制文件的外部而不是内部。仅在'--onefile'编译情况下该选项才有意义。首先，必须以某种方式指定文件以某种方式为已包含，然后这个选项将引用分发中的目标路径。默认为空。

输出给定包名称找到的数据文件。默认不执行

将原始文件夹完整地包含在分发中。这是递归的。检查 '--include-data-dir' 以使用正确的选项。默认为空。

输出所有包的分发列表及其详细信息。默认不执行。

为给定的分发名称包含元数据信息。有些包会检查元数据的存在、版本、入口点灯，而如果没有给出这些选项，它只能在编译时被识别才会工作，这并不总是会发生。当然，这只对包含在编译中的包有意义。默认为空。

不要包括与给定文件名模式匹配的DLL文件。这是针对目标文件名，而不是源路径。因此，要忽略包含在“package_name”包中的DLL“someDLL”，应将其匹配为“package_name/someDLL.*”。默认为空。

为给定的包名找到DLLs并输出。默认不执行。

输出给定包名找到的EXE文件。默认不执行。

启用对在编译时检测到的隐式异常的警告。

启用对在编译时对检测到的不寻常代码的警告。

在需要时允许Nuitka下载外部代码。例如依赖项walker,ccache,甚至Windows上的gcc。要禁用，请从nul设备重定向输入。例如"</dev/null"或"<NUL:"。默认下载时提示。

禁用给定助记符的警告。这些是为了确保你知道某些主题，并且通常指向Nuitka网站。助记符是URL末尾的部分，没有HTML后缀。可以多次给出并接受shell模式。默认为空。

立即执行创建的二进制文件(或导入已编译的模块)。默认关闭。

在调试器（例如 "gdb" 或 "lldb"）中执行，以自动获取堆栈跟踪。除非通过 NUITKA_DEBUGGER_CHOICE 环境变量指定调试器名称，否则将自动选择调试器。默认关闭。

确保和CPython绝对兼容。甚至不允许与CPython行为的轻微偏差，例如没有更好的跟踪回溯(trackback)或异常消息。这些行为并不是真正的不兼容，而只是不同或者更糟糕而已。这仅用于测试，不应该使用。

用户提供包含包配置的Yaml文件. 您可以包括DLL文件,删除冗余，添加隐藏的依赖项。请查阅Nuitka包配置手册，以获取完整的格式使用说明。可以多次给出。默认为空。

选择"__file__"的值。创建的二进制文件和模块"执行时"（即独立二进制文件和摸块模式的默认值)使用自己的位置来扣除"__file__"的值。包含的软件包假装在该位置下方的目录中。这样就可以在部署中包含数据文件。如果只是为了加速，最好使用"原始(original)"值，其中将使用源文件位置。也就是使用源文件的位置。使用"frozen"的时候，会使用"＜frozen module_name＞"符号。出于兼容性的原因，"__file__"值将始终具有".py"后缀，而与它的实际值无关。

选择"__name__"和"__package__"的值。使用"执行时(runtime)"（模块模式的默认值）创建的模块使用软件包来推断"__package__"的值，以实现完全兼容。"原始(original)"值（其他模式的默认值）允许进行更多的静态优化，但对那些通常可以加载到任意软件包的模块来说是不兼容的。

生成exe或者模块文件后删除构建文件夹。默认关闭。

不要为Nuitka创建拓展模块而创建".pyi"文件用于检测隐式导入。默认关闭。

在为使用 Nuitka 创建的扩展模块生成 '.pyi' 文件时，不要使用 stubgen。它们会暴露你的 API，但 stubgen 可能会导致问题。默认关闭

指定可执行文件的名称。拓展模块和独立模式没有这个选项，使用时会报错。这可能需要包含存在的路径信息。默认为当前平台上的"＜program_name＞.exe"

指定存放中间文件和最终输出文件的位置。选定目录将存放构建文件夹，发行文件夹，二进制文件等。默认为当前目录。

禁用旨在让查找兼容性问题更容易的代码。例如，这将阻止使用'-c'参数的执行，这个参数一般被尝试运行模块的代码使用，并且可能导致程序反复自启动。一旦你向最终用户部署，就禁用它，对于查找典型问题，这在开发过程中非常有帮助。默认关闭。

保持部署模式，但是选择性地禁用部分功能。部署模式的错误将会输出这些标识符。默认为空

将环境变量强制设置为给定值。默认为空。

执行所有可能的自身检查以发现Nuitka中的错误，请不要用与生产中。默认关闭。

禁用通常使用 "--debug" 进行的检查。在 Python 3.12 及以上版本中，不检查已知的不朽对象(Immortal Objects)假设。一些 C 库会破坏它们。如果启用了 "--debug"，默认会进行检查。

禁用通常使用"--debug"完成的检查。 C编译可能会产生警告，对于某些包来说这通常不是问题，特别是对于未使用的值。

在生成的对象文件中保留调试信息，以便更好的和调试器交互。默认关闭。

启用基于vmprof的耗时分析。目前无法使用。默认关闭。

跟踪执行并输出。在执行代码之前输出代码行。默认关闭。

尝试使用更少的内存，方法是减少C编译任务的分叉并使用更少内存的选项。用于嵌入式机器。在出现内存不足的问题时使用。默认为关闭。

只生成C源代码，不编译为二进制文件或者模块。这是用于调试和代码覆盖分析的，不会浪费CPU。默认关闭。不要认为你可以直接使用这个。

将内部程序结构和优化结果以XML形式写入给定的文件名。

使用声明为"实验性"的功能。如果代码中没有实验性功能，则可能不会产生任何影响。使用每个实验功能的秘密标签(检查源代码)。

根据给出的报告文件在不存在的路径中创建一个新的虚拟环境，例如'--report=compilation-report.xml'。默认不执行。

报告尝试但不存在的类型的代码助手的警告。这有助于识别通过未使用的类型知识来改进生成的代码优化机会。默认为 False。

报告可以信任但目前没有的导入的警告。这是为了识别改进处理硬模块的机会，这有时可以允许更多的静态优化。默认为 False。

这不是增量编译，仅用于 Nuitka 开发。将现有文件重新编译为C。允许编译编辑过的C文件，以便对生成源代码的修改进行快速调试。例如查看代码是否通过，值的输出等。默认关闭。它要查看的文件取决于编译Python源代码。

创建优化过程内部的图，不要用于整个程序，请只用于小的测试用例。默认关闭。

强制使用 clang 编译。在 Windows 系统上，这需要一个正常运行的 Visual Studio 版本来支持。默认关闭。

强制在 Windows 上使用 MinGW64。默认为关闭，除非使用 MSYS2 和 MinGW Python。

使用链接时间优化（MSVC、gcc、clang）允许的值有 "yes"（是）、"no"（否）和 "auto"（自动）(已知可用)。默认为 "auto"。

使用Python的静态链接库。允许的值有 "yes"（是）、"no"（否）和 "auto"（自动）(已知可用)。默认为 "auto"。

强制在Windows上使用特定的MSVC版本。允许的值有"14.3" (MSVC 2022)和其他MSVC版本号。使用 "list "以获得已安装编译器的列表，或使用 "latest"。默认在有的情况下使用最新的MSVC。否则使用MinGW64。

指定允许的并行 C 编译器作业数量。负值表示系统的 CPU 数量减去给定值。默认情况下，除非启用低内存模式，否则会使用系统 CPU 的全部数量；若在低内存模式下，默认值为 1。

这个选项是特定于gcc的。为gcc编译器选择"cf-protection"(cf保护)模式。默认值"auto"是使用gcc的默认值，但你可以覆盖它，例如，使用"none"值来禁用它。有关"-fcf-protection"的详细信息，请参阅gcc文档

不要尝试使用ccache(gcc,clang等)或clcache(MSVC,clangcl)。与--disable-cache=ccache效果相同。

禁用依赖项分析器缓存。这将导致创建分发文件夹的时间大大延长，但如果怀疑缓存会导致错误，则可以使用它。与--disable-cache=dll-dependencies效果相同。

用于更新依赖分析器缓存。这将导致创建分发文件夹的时间大大延长，但如果怀疑缓存会导致错误或缓存需要更新，则可以使用它。

禁用选定的缓存，设置"all"则为所有缓存。当前允许的值有："all(全部)","ccache","bytecode(字节码)", "compression(压缩)","dll-dependencies(dll依赖项)"。可以多次给出或使用逗号分隔给定的值。默认为无。

在执行前清理给定缓存，设置"all"则为所有缓存。当前允许的值有： "all(全部)","ccache","bytecode(字节码)","compression(压缩)","dll-dependencies(dll依赖项)"。可以多次给出或使用逗号分隔给定的值。默认为无。

通过先进行分析，然后使用结果来反馈到C编译中，启用C级别的配置文件引导优化（PGO）。注意：这是实验性的，还不能与Nuitka的独立模式一起使用。默认关闭。

在进行配置文件引导优化(PGO)时传递的参数。这些参数在配置文件引导优化(PGO)分析运行期间传递给被特殊的构建可执行文件。默认为空。

收集配置文件信息时要执行的命令。只有在需要通过准备运行的脚本来启动它时才使用它。默认使用创建的程序。

以可比较的方式报告数据，即没有随着运行而变化的时间或内存使用值。默认关闭。

禁止所有信息输出，但显示警告。默认关闭。

运行C构建后端Scons，显示执行的命令、检测到的编译器的详细信息。默认关闭。

禁用进度条。默认关闭。

过时: 提供进度信息和统计信息。禁用正常的进度条。默认关闭。

显示内存使用情况。默认关闭。

过时: 您应该使用'--report'文件替代。提供包含的模块和DLL的信息。默认关闭。

输出采取的操作的详细信息，尤其是在优化过程中可能会大量输出。默认关闭。

输入一个XML文件名，在XML输出文件中报告模块、数据文件、编译、插件等详细信息。这对于报告问题也非常有用。例如，这些报告可以用于使用’–create-environment-from-report’轻松重建环境，但报告包含大量信息。默认关闭。

用于设定输出'--show-modules'的位置，应该是一个文件名。默认为标准输出。

用于设定输出'--verbose'的位置，应该是一个文件名。默认为标准输出。

报告来自您的数据。这可以多次给出，并且可以是任何形式的"key=value"，其中key应该是一个标识符，例如使用"--report-user-provided=pipenv-lock-hash=64a5e4"来跟踪一些输入值。默认为空。

通过模板报告。需要提供模板和输出文件名"template.rst.j2:output.rst"。对于内置模板，请查看用户手册。可以多次给出。默认为空。

强制程序的标准输出输出到这个位置。对于禁用控制台的程序和使用Nuitka商业版的Windows服务插件的程序非常有用。默认不激活，例如使用'.out.txt'，也就是程序目录附近的文件，查看用户手册以获取可用值的完整列表。

强制程序的标准错误输出到这个位置。对于禁用控制台的程序和使用Nuitka商业版的Windows服务插件的程序非常有用。默认不激活，例如使用'.err.txt'，也就是程序目录附近的文件，查看用户手册以获取可用值的完整列表。

向Windows用户控制(UAC)请求在执行时授予管理员权限。(仅限Windows)。默认关闭。

请求Windows用户控制权限(UAC)，用于强制在特定的几个文件夹中运行和远程桌面访问。(仅限Windows)。默认关闭。

选择要使用的控制台模式，默认模式是force

当编译为Windows下的单文件时，在加载应用程序时显示这个图像。默认关闭。

添加可执行文件的图标。可以多次给出不同分辨率或者包含多个图标的文件。在选择包含多个图标的文件时，您也可以使用＃＜n＞后缀来指定要包含的特定图标并忽略其他所有的图标，其中n是从1开始的整数索引

复制来自该可执行文件的图标(仅限Windows)。

在为macOS编译时，创建一个包而不是一个普通的二进制应用程序。这是禁用控制台、获取高DPI图形等的唯一方式，并且将开启独立模式。默认为关闭。

当进行用于公证的签名时，使用来自Apple的正确的TeamID标识，使用所需的运行时签名选项，以便它可以被接受。

应用程序捆绑包的应用程序模式。

这个程序应该在什么架构上运行。默认值和限制是运行Python允许的。默认值为"native"，这是Python运行的架构。

教程

主题

语言

界面语言

命令语言

存储设置

用户设置

命令设置