USAGE_CN.md

July 15, 2026 · View on GitHub

使用说明

Box64 有许多环境变量可用于控制其行为，下面将按类别列出。

Box64 有两种构建类型：Wine WOW64 构建（WowBox64）和常规 Linux 构建。请注意，只有部分环境变量在 WowBox64 中可用。

配置文件

除了环境变量之外，如果你使用的是常规 Linux 构建，Box64 默认还会在两个位置查找 rcfile：系统范围的 /etc/box64.box64rc 和用户目录下的 ~/.box64rc。而在 WowBox64 中，配置文件仅在 %USERPROFILE%/.box64rc 处检查。设置的优先级如下（从高到低）：~/.box64rc > /etc/box64.box64rc > 环境变量。

配置示例：

[factorio]
BOX64_DYNAREC_SAFEFLAGS=0
BOX64_DYNAREC_BIGBLOCK=2
BOX64_DYNAREC_FORWARD=1024
BOX64_DYNAREC_CALLRET=1

此配置将使所有名为 factorio 的可执行文件应用指定的设置。

共享选项也可以定义在特殊的 [*] 配置段中。这些设置会全局应用，而更具体的配置段只会覆盖它自己显式定义的选项。

Linux 构建的高级用法

通配符匹配

可以使用星号（*）对应用程序名称进行基本的模式匹配。例如，[*setup*] 将匹配名称中包含 "setup" 的任何程序。请注意，这里实现的是简单的通配符匹配，而非完整的正则表达式支持。
共享设置

特殊的 [*] 配置段可为所有应用程序定义共享的 rcfile 选项。它不同于 [*setup*] 这类通配符配置段，是一个专用的全局配置段。
自定义配置文件

BOX64_RCFILE 环境变量可以指定一个替代的配置文件，而不是默认的 /etc/box64.box64rc。
按文件设置

以 / 开头的配置项适用于特定文件。例如：
```
[/d3d9.dll]
BOX64_DYNAREC_SAFEFLAGS=0
```
这些设置将仅影响 d3d9.dll 文件。此语法同样适用于模拟的 Linux 库，例如 [/libstdc++.so.6]。

性能

BOX64_DYNAREC

启用或禁用动态重编译器（DynaRec）。如果在支持的架构上构建时开启了 DynaRec 支持，则默认为 1。在 WowBox64 中可用。

0: 禁用 DynaRec。
1: 启用 DynaRec。

BOX64_DYNAREC_ALIGNED_ATOMICS

仅生成对齐的原子操作（目前仅在 Arm64 上可用）。在 WowBox64 中可用。

0: 生成非对齐原子操作处理代码。 [默认值]
1: 仅生成对齐的原子操作，代码更快更小，但在非对齐数据地址上执行 LOCK 前缀指令时会导致 SIGBUS。

BOX64_DYNAREC_BIGBLOCK

尝试构建更大的代码块以提高性能。在 WowBox64 中可用。

0: 不尝试构建尽可能大的代码块，适用于使用大量线程和 JIT 的程序（如 Unity）。
1: 尽可能构建大的代码块。
2: 构建更大的代码块，代码块重叠时不停止，但仅针对 elf 内存中的代码块。 [默认值]
3: 构建更大的代码块，代码块重叠时不停止，适用于所有类型的内存，因此也对 Wine 程序有用。

BOX64_DYNAREC_CALLRET

优化 CALL/RET 指令。在 WowBox64 中可用。

0: 不优化 CALL/RET，使用跳转表。
1: 尝试优化 CALL/RET，在可能的情况下跳过跳转表。
2: 尝试优化 CALL/RET，在可能的情况下跳过跳转表，同时增加对返回到脏/已修改代码块的代码的处理。在 WowBox64 上不可用。 [默认值]

BOX64_DYNAREC_SEP

使用二级入口点（SEP）进一步优化 CALL/RET。如果 CALLRET 未启用则无效。在 WowBox64 中可用。

0: 不在 CALLRET 返回时添加 SEP。 [默认值]
1: 在 CALLRET 返回时添加 SEP，仅针对来自已知二进制文件的内存。
2: 在 CALLRET 返回时添加 SEP，适用于所有类型的内存。

BOX64_DYNAREC_DF

启用或禁用延迟 FLAGS 的使用。在 WowBox64 中可用。

0: 禁用延迟 FLAGS 的使用。
1: 启用延迟 FLAGS 的使用。 [默认值]

BOX64_DYNAREC_DIRTY

是否允许继续运行未受保护且可能已脏的代码块。

0: 不允许继续运行未受保护且可能已脏的代码块。 [默认值]
1: 允许继续运行在与代码相同页面中写入数据的代码块，可以加快某些游戏的加载时间，但也可能导致意外崩溃。
2: 除了 1 之外，当检测到热页时，将该页面标记为永不写保护，但基于该页面构建的代码块将始终被测试。这样可以更快（但某些 SMC 情况可能无法捕获）。

BOX64_DYNAREC_NOHOTPAGE

是否禁用热页检测（即代码执行和数据写入同时发生的页面）。

0: 检测热页。 [默认值]
1: 不检测热页。

BOX64_DYNAREC_FASTNAN

启用或禁用快速 NaN 处理。在 WowBox64 中可用。

0: 精确模拟 x86 上的 -NaN 生成。
1: 不对 -NaN 生成做任何特殊处理，速度更快。 [默认值]

BOX64_DYNAREC_FASTROUND

启用或禁用快速舍入。在 WowBox64 中可用。

0: 生成 float/double -> int 舍入，并使用当前舍入模式进行 float/double 计算，类似 x86。
1: 不对边缘情况的舍入做任何特殊处理，速度更快。 [默认值]
2: 使用当前舍入模式生成 float/double -> int 舍入（类似 x86），但使用快速的 int -> float/double 转换。

BOX64_DYNAREC_FORWARD

定义构建代码块时允许的最大前向跳转值。仅接受 0、128、256、512 和 1024；其他值将回退为 128。在 WowBox64 中可用。

0: 无前向跳转值。当前代码块结束时，即使存在之前的前向跳转也不尝试继续前进。
128: 允许代码块结束与下一个前向跳转之间最多 128 字节的间隙。 [默认值]
256: 允许代码块结束与下一个前向跳转之间最多 256 字节的间隙。
512: 允许代码块结束与下一个前向跳转之间最多 512 字节的间隙。
1024: 允许代码块结束与下一个前向跳转之间最多 1024 字节的间隙。

BOX64_DYNAREC_NATIVEFLAGS

启用或禁用原生FLAGS的使用。在 WowBox64 中可用。

0: 不使用原生FLAGS。
1: 在可能的情况下使用原生FLAGS。 [默认值]

BOX64_DYNAREC_PAUSE

启用 x86 PAUSE 模拟，可能有助于自旋锁的性能。在 WowBox64 中可用。

0: 忽略 x86 PAUSE 指令。 [默认值]
1: 使用 YIELD 模拟 x86 PAUSE 指令。
2: 使用 WFI 模拟 x86 PAUSE 指令。
3: 使用 SEVL+WFE 模拟 x86 PAUSE 指令。

BOX64_DYNAREC_SAFEFLAGS

在 CALL/RET 指令和其他边缘情况下 FLAGS 模拟的行为。在 WowBox64 中可用。

0: 将 CALL/RET 标记为从不需要任何 FLAGS。
1: 将大多数 RET 标记为需要 FLAGS，将大多数 CALL 标记为不需要。 [默认值]
2: 将所有 CALL/RET 都标记为需要 FLAGS。同时也处理所有边缘情况。

BOX64_DYNAREC_STRONGMEM

开启或关闭 x86 强内存模型的模拟。在 WowBox64 中可用。

0: 不做任何特殊处理。 [默认值]
1: 在写入内存时启用以有限方式模拟 x86 强内存模型的内存屏障。
2: 包含 1 的全部内容，外加 SIMD 指令的内存屏障。
3: 包含 2 的全部内容，外加定期添加更多内存屏障。
4: 模仿 x86 TSO，类似 QEMU 的方法，可用于评估目的。

BOX64_DYNAREC_VOLATILE_METADATA

使用从 PE 文件解析的 volatile 元数据，仅对 64 位 Windows 游戏有效。

0: 不使用 volatile 元数据。
1: 使用 volatile 元数据，将指导 Box64 进行更好的强内存模拟。 [默认值]

BOX64_DYNACACHE

启用或禁用动态重编译器缓存（DynaCache）。此选项默认为 1（启用）。DynaCache 默认将文件写入 home 文件夹，生成新缓存文件时会根据 BOX64_DYNACACHE_LIMIT 控制文件夹大小。

0: 禁用 DynaCache。
1: 启用 DynaCache。 [默认值]
2: 使用已有的 DynaCache 文件，但不生成新的。

BOX64_DYNACACHE_FOLDER

设置 DynaCache 文件的文件夹。默认为 $XDG_CACHE_HOME/box64，如果$ XDG_CACHE_HOME 未设置则为 $HOME/.cache/box64。

XXXX: 使用文件夹 XXXX 存储 DynaCache 文件。

BOX64_DYNACACHE_LIMIT

DynaCache 文件夹的最大大小（MiB）。超过限制时，会先删除无效的 DynaCache 文件，如仍超限再删除最旧的有效文件。默认大小为 2048MiB。

0: 不限制 DynaCache 文件夹大小。
XXXX: 先删除无效缓存文件，如仍超限再删除最旧的有效缓存文件，将 DynaCache 文件夹保持在 XXXX MiB 以下。
2048: 默认值为 2048 MiB。 [默认值]

BOX64_DYNACACHE_COMPRESS

设置是否压缩磁盘上的 DynaCache 文件。

0: 不压缩 DynaCache 文件。
1: 使用 Zlib 最快压缩级别压缩 DynaCache 文件。 [默认值]
2: 使用 Zlib 默认压缩级别压缩 DynaCache 文件。

BOX64_DYNACACHE_MIN

DynaCache 写入磁盘的最小大小（KB）。默认大小为 30KB。

XXXX: 设置将缓存写入磁盘的最小 DynaRec 代码大小（XXXX KB），小于此值将不会保存到磁盘。
30: 默认值为 30 KB。 [默认值]

BOX64_SKIPCPU

Skip N first CPU cores (Is apply before MAXCPU) 在 WowBox64 中可用。

0: Do not skip any CPU cores. [默认值]
XXXX: Skip XXXX first CPU cores (usefull for big.LITTLE configurations).

BOX64_MMAP32

在运行 32 位代码的 64 位程序（如 Wine WOW64）上强制使用 32 位兼容的内存映射，可提高性能。

0: 不强制使用 32 位内存映射。
1: 强制使用 32 位内存映射。 [默认值]

BOX64_DYNAREC_NOARCH

从代码块中移除架构元数据（在信号处理时使用）。在 WowBox64 中可用。

0: 为每个代码块生成所有架构元数据，包括 x87/mmx/SSE/AVX 寄存器追踪。会使用更多内存。 [默认值]
1: 仅生成每个代码块的必要元数据（FLAGS、对齐），节省一些内存，但某些加密软件可能会失败。
2: 不为代码块生成元数据，进一步节省内存，但在信号处理时可能会失败。

BOX64_RDTSC_1GHZ

如果可用，使用硬件计数器实现 rdtsc。

0: 如果可用，使用硬件计数器实现 rdtsc 指令。 [默认值]
1: 仅当精度至少为 1GHz 时，使用硬件计数器实现 rdtsc。

不稳定或遗留选项

BOX64_DYNAREC_PURGE

根据年龄阈值（BOX64_DYNAREC_PURGE_AGE）清除最近未执行的代码块。

0: DynaRec 不会清除旧的未使用代码块。 [默认值]
1: DynaRec 将根据年龄阈值清除旧的未使用代码块。

BOX64_DYNAREC_PURGE_AGE

代码块清除的年龄阈值（需要 BOX64_DYNAREC_PURGE=1）。

4096: 默认年龄阈值。 [默认值]
XXXX: 自定义年龄阈值（范围：10-65536）。

BOX64_DYNAREC_WAIT

是否等待代码块构建完成。在 WowBox64 中可用。

0: 不等待，改用解释器，可能在大量多线程或 JIT 程序上略微加速。
1: 等待代码块构建完成。 [默认值]

BOX64_DYNAREC_WEAKBARRIER

调整内存屏障以减少强内存模拟的性能影响。在 WowBox64 中可用。

0: 使用常规安全屏障。
1: 使用弱屏障以获得更多性能提升。 [默认值]
2: 包含 1 的全部内容，外加禁用最后的写屏障。

兼容性

BOX64_AES

是否暴露 AES 能力。在 WowBox64 中可用。

0: 不暴露 AES 能力。
1: 暴露 AES 能力。 [默认值]

BOX64_ARCH

在 rcfile 中指定当前条目适用的架构。此选项仅在 rcfile 中使用时生效。

arm64: 仅对 AArch64 应用当前条目。
la64: 仅对 LoongArch64 应用当前条目。
rv64: 仅对 RISC-V 应用当前条目。
<empty>: 对所有架构应用当前条目，但如果存在更具体的条目，当前条目将被替换。 [默认值]

BOX64_AVX

向 CPUID 和 cpuinfo 文件暴露 AVX 扩展。在 Arm64 和龙架构上默认值为 2，因为 DynaRec 已完全实现，其他架构默认为 0。在 WowBox64 中可用。

0: 不暴露 AVX 能力。
1: 向 CPUID 和 cpuinfo 文件暴露 AVX、BMI1、F16C 和 VAES 扩展。
2: 包含 1 的全部内容，外加 AVX2、BMI2、FMA、ADX、VPCLMULQDQ 和 RDRAND 扩展。

BOX64_BASH

用于指定 bash 可执行文件的路径。

XXXX: 使用路径为 XXXX 的 bash 可执行文件。

BOX64_CPUTYPE

指定要模拟的 CPU 类型。在 WowBox64 中可用。

0: 模拟某个 Intel CPU 型号。 [默认值]
1: 模拟某个 AMD CPU 型号。

BOX64_CRASHHANDLER

是否使用模拟的 crashhandler.so 库。

0: 在需要时使用模拟的 crashhandler.so 库。
1: 使用内部定义的空 crashhandler.so 库。 [默认值]

BOX64_DYNAREC_BLEEDING_EDGE

检测 MonoBleedingEdge 并应用保守设置（仅 Linux）。

0: 不检测 MonoBleedingEdge。
1: 检测 MonoBleedingEdge，并在检测到时应用 BOX64_DYNAREC_BIGBLOCK=0 和 BOX64_DYNAREC_STRONGMEM=1。 [默认值]

BOX64_DYNAREC_DIV0

启用或禁用除零异常的生成。在 WowBox64 中可用。

0: 不生成除零异常。 [默认值]
1: 生成除零异常。

BOX64_DYNAREC_TBB

启用或禁用 libtbb 检测。

0: 不检测 libtbb。
1: 检测 libtbb 并应用保守设置。 [默认值]

BOX64_DYNAREC_X87DOUBLE

强制使用 float/double 进行 x87 模拟。在 WowBox64 中可用。

0: 尝试在可能的情况下对 x87 模拟使用 float。 [默认值]
1: 仅对 x87 模拟使用 Double。
2: 在 x87 模拟中检查精度控制的低精度。

BOX64_DYNAREC_INTERP_SIGNAL

允许在信号处理器中使用 DynaRec。

0: 允许在信号处理器中使用 DynaRec。 [默认值]
1: 仅在信号处理器中使用解释器（与 v0.3.8 及更早版本相同）。

BOX64_EXIT

直接退出，不运行程序。

0: 不执行任何操作。 [默认值]
1: 直接退出。

BOX64_FIX_64BIT_INODES

修复 64 位 inode。

0: 不修复 64 位 inode。 [默认值]
1: 修复 64 位 inode。

BOX64_FORCE_LD_PRELOAD

是否强制 BOX64_LD_PRELOAD 库中的符号通过 RTLD_NEXT 解析。

0: 不执行任何操作。 [默认值]
1: 强制 BOX64_LD_PRELOAD 库中的符号通过 RTLD_NEXT 解析。

BOX64_IGNOREINT3

忽略 INT3 指令。

0: 如果存在处理器则触发 TRAP 信号。 [默认值]
1: 静默跳过该指令。

BOX64_JVM

检测 libjvm 并应用保守设置。

0: 不执行任何操作。
1: 检测 libjvm，并在检测到时应用 BOX64_DYNAREC_BIGBLOCK=0 BOX64_DYNAREC_STRONGMEM=1 BOX64_SSE42=0。 [默认值]

BOX64_LIBCEF

检测 libcef 并应用 BOX64_MALLOC_HACK 设置。

0: 不执行任何操作。 [默认值]
1: 检测 libcef，并在检测到时应用 BOX64_MALLOC_HACK=2。

BOX64_MALLOC_HACK

挂钩 malloc 操作符时的行为。

0: 不允许重定向 malloc 操作符，重写代码使用常规函数。 [默认值]
1: 允许重定向 malloc 操作符。
2: 与 0 类似，但追踪特殊的 mmap/free（某些内联的重定向函数无法被重定向）。

BOX64_MAXCPU

暴露的最大 CPU 核心数。在 WowBox64 中可用。

0: 使用实际的 CPU 核心数。 [默认值]
XXXX: 使用 XXXX 个 CPU 核心。

BOX64_NORCFILES

不加载任何 rc 文件。

0: 加载 rc 文件。 [默认值]
1: 不加载任何 rc 文件。

BOX64_PATH

查找 x86_64 二进制文件的路径。

XXXX: 将路径 XXXX 添加到二进制搜索路径。

BOX64_PCLMULQDQ

暴露 PCLMULQDQ 能力。在 WowBox64 中可用。

0: 不暴露 PCLMULQDQ 能力。
1: 暴露 PCLMULQDQ 能力。 [默认值]

BOX64_PROFILE

预定义的环境变量集合，以兼容性或性能为导向。在 WowBox64 中可用。

safest: 禁用所有不安全的优化。
safe: 仅启用小部分不安全的优化。
default: 大多数程序都能正常运行且性能适中的默认设置。 [默认值]
fast: 启用许多不安全的优化，但同时启用强内存模型模拟。
fastest: 启用许多不安全的优化以获得更好的性能。

BOX64_PYTHON3

python3 可执行文件的路径。

XXXX: 使用路径为 XXXX 的 python3 可执行文件。

BOX64_RCFILE

要加载的 rc 文件路径。

XXXX: 加载 rc 文件 XXXX，不会加载默认的 rc 文件。

BOX64_RDTSC_INV

在 Intel CPU 类型的 CPUID 中报告 Invariant TSC 位。在 WowBox64 中可用。

0: 不为 Intel CPU 类型报告 Invariant TSC（默认）。 [默认值]
1: 在 Intel CPU 类型的 CPUID leaf 0x80000007 中报告 Invariant TSC 位。

BOX64_RESERVE_HIGH

为程序保留高内存区域，在 Box32 上始终启用。

0: 不为程序保留高内存区域。 [默认值]
1: 为程序保留高内存区域。

BOX64_SDL2_JGUID

对包装的 SDL2 使用 SDL_GetJoystickGUIDInfo 函数的变通方案。

0: 不执行任何操作。 [默认值]
1: 对包装的 SDL2 使用 SDL_GetJoystickGUIDInfo 函数的变通方案。

BOX64_SHAEXT

暴露 SHAEXT（即 SHA_NI）能力。在 WowBox64 中可用。

0: 不暴露 SHAEXT 能力。
1: 暴露 SHAEXT 能力。 [默认值]

BOX64_SSE_FLUSHTO0

SSE Flush to 0 FLAGS的行为，同时追踪 SSE 异常 FLAGS。在 WowBox64 中可用。

0: 仅追踪 FLAGS。 [默认值]
1: 直接应用 SSE Flush to 0 FLAGS。同时在 DynaRec 中反映 SSE 异常 FLAGS（如果可用）。

BOX64_SSE42

暴露 SSE4.2 能力。在 WowBox64 中可用。

0: 不暴露 SSE4.2 能力。
1: 暴露 SSE4.2 能力。 [默认值]

BOX64_STEAM_VULKAN

为 Linux Steam UI 强制使用 Vulkan。

0: 不执行任何操作。 [默认值]
1: 为 Linux Steam UI 强制使用 Vulkan。

BOX64_SYNC_ROUNDING

在 x86 和原生之间同步舍入模式。

0: 不同步舍入模式。 [默认值]
1: 在 x86 和原生之间同步舍入模式。

BOX64_UNITYPLAYER

检测 UnityPlayer 并应用保守设置。

0: 不执行任何操作。
1: 检测 UnityPlayer（Windows 或 Linux），并在检测到时应用 BOX64_UNITY=1。 [默认值]

BOX64_UNITY

告诉 Box64 这是一个 Unity 游戏。

0: 不执行任何操作。
1: 这是 Unity 游戏，对 Windows 使用特殊的检测代码，对 Linux 应用 BOX64_DYNAREC_STRONGMEM=1。 [默认值]

BOX64_X11GLX

是否强制 Xorg GLX 扩展存在。

0: 不强制 Xorg GLX 扩展存在。 [默认值]
1: 在使用 XQueryExtension 时要求 Xorg GLX 扩展存在。

BOX64_X11SYNC

是否强制 X11 显示同步操作。

0: 不强制 X11 显示同步操作。 [默认值]
1: 强制 X11 显示同步操作。

BOX64_X11THREADS

加载 X11 时调用 XInitThreads。这主要用于使用 Loki_Compat 库的旧 Loki 游戏。

0: 不调用 XInitThreads。 [默认值]
1: 一旦加载 libX11 就调用 XInitThreads。

BOX64_X87_NO80BITS

x87 80 位 long double 的行为。在 WowBox64 中可用。

0: 尝试尽可能精确地处理 80 位 long double。 [默认值]
1: 对 x87 使用 64 位 double。

BOX64_NOPERSONA32BITS

禁用 32 位二进制文件的自动 personality 切换（在 Box32 上始终启用）。

0: 为 32 位二进制文件切换 personality（如果尚未尝试）。 [默认值]
1: 不为 32 位二进制文件切换 personality。

参数

BOX64_ARGS

传递给目标程序的参数，仅在没有任何已有参数时有效。

XXXX: 将 XXXX 参数传递给目标程序。
XXXX YYYY ZZZZ: 将 XXXX、YYYY 和 ZZZZ 参数传递给目标程序。

BOX64_INSERT_ARGS

在命令行前添加参数。

XXXX: 在程序前添加参数 XXXX。
XXXX YYYY ZZZZ: 在目标程序前添加参数 XXXX、YYYY 和 ZZZZ。

BOX64_INPROCESSGPU

向目标程序添加 --in-process-gpu 参数。

0: 不执行任何操作。 [默认值]
1: 向目标程序添加 --in-process-gpu 参数。

BOX64_NOSANDBOX

向目标程序添加 --no-sandbox 参数。

0: 不执行任何操作。 [默认值]
1: 向目标程序添加 --no-sandbox 参数。

库

BOX64_ADDLIBS

添加额外需要的共享库（这个选项不太常用）。

XXXX: 将 XXXX 共享库添加到所需库列表。
XXXX:YYYY:ZZZZ: 将 XXXX、YYYY 和 ZZZZ 共享库添加到所需库列表。

BOX64_ALLOWMISSINGLIBS

是否允许忽略缺失的共享库。

0: 不允许忽略缺失的共享库。 [默认值]
1: 允许忽略缺失的共享库。

BOX64_EMULATED_LIBS

强制使用模拟库。

XXXX: 强制使用模拟库 XXXX。
XXXX:YYYY:ZZZZ: 强制使用模拟库 XXXX、YYYY 和 ZZZZ。

BOX64_LD_LIBRARY_PATH

查找 x86_64 库的路径。

XXXX: 将路径 XXXX 添加到库搜索路径。

BOX64_LD_PRELOAD

强制随二进制文件加载库。

XXXX: 强制加载库 XXXX。
XXXX:YYYY: 强制加载库 XXXX 和 YYYY。

BOX64_LIBGL

设置 libGL 的名称。

libXXXX: 将 libGL 的名称设置为 libXXXX。
/path/to/libXXXX: 将 libGL 的名称和路径设置为 /path/to/libXXXX，你也可以使用 SDL_VIDEO_GL_DRIVER。

BOX64_NOGTK

不加载包装的 GTK 库。

0: 加载包装的 GTK 库。 [默认值]
1: 不加载包装的 GTK 库。

BOX64_NOPULSE

不加载 PulseAudio 库（原生库和模拟库均不加载）。

0: 加载 PulseAudio 库。 [默认值]
1: 不加载 PulseAudio 库。

BOX64_NOVULKAN

不加载 Vulkan 库。

0: 加载 Vulkan 库。 [默认值]
1: 不加载 Vulkan 库，原生库和模拟库均不加载。

BOX64_NOVULKANOVERLAY

不加载 x64 Vulkan 覆盖层。

0: 尝试加载 x64 Vulkan 覆盖层。 [默认值]
1: 不加载 x64 Vulkan 覆盖层。

BOX64_PREFER_EMULATED

优先使用模拟库而非原生库。

0: 优先使用原生库而非模拟库。 [默认值]
1: 优先使用模拟库而非原生库。

BOX64_PREFER_WRAPPED

即使库使用绝对路径指定，也优先使用包装库。

0: 优先使用绝对路径指定的库而非包装库。 [默认值]
1: 即使库使用绝对路径指定，也优先使用包装库。

BOX64_WRAP_EGL

优先使用包装库处理 EGL 和 GLESv2。

0: 优先使用模拟库处理 EGL 和 GLESv2。 [默认值]
1: 优先使用包装库处理 EGL 和 GLESv2。

环境变量

BOX64_ENV

添加环境变量。

XXXX=yyyy: 添加值为 yyyy 的环境变量 XXXX。

BOX64_ENV[1-5]

添加环境变量。

XXXX=yyyy: 添加值为 yyyy 的环境变量 XXXX。

调试

BOX64_DLSYM_ERROR

启用或禁用 dlsym 错误的日志记录。

0: 禁用 dlsym 错误的日志记录。 [默认值]
1: 启用 dlsym 错误的日志记录。

BOX64_DUMP

是否输出 elfloader 调试信息。在 WowBox64 中可用。

0: 不输出 elfloader 调试信息。 [默认值]
1: 输出 elfloader 调试信息。

BOX64_DYNAREC_DUMP

启用 DynaRec 转储。在 WowBox64 中可用。

0: 不转储代码块。 [默认值]
1: 转储代码块。
2: 转储代码块并带有颜色。
3: 仅转储 x86 指令和翻译后的本机指令。

BOX64_DYNAREC_DUMP_RANGE

转储指定范围内的代码块。在 WowBox64 中可用。

0xXXXXXXXX-0xYYYYYYYY: 定义代码块被转储的范围（左闭右开）。

BOX64_DYNAREC_GDBJIT

GDBJIT 调试支持，仅在使用 -DGDBJIT=ON 构建时可用，通过 gdb 命令启用：jit-reader-load /usr/local/lib/libbox64gdbjitreader.so。

0: DynaRec 不会生成 GDBJIT 调试信息。 [默认值]
1: DynaRec 将生成 GDBJIT 调试信息。
2: DynaRec 将生成包含内部状态的详细 GDBJIT 调试信息。
3: DynaRec 将仅对目标程序陷入的代码块注册详细的 GDBJIT 调试信息，大幅提升性能。
0xXXXXXXX-0xYYYYYYY: 定义 DynaRec 将生成包含内部状态的详细 GDBJIT 调试信息的范围。

BOX64_DYNAREC_LOG

禁用或启用 DynaRec 日志。在 WowBox64 中可用。

0: 禁用 DynaRec 日志。 [默认值]
1: 启用最小级别的 DynaRec 日志。
2: 启用调试级别的 DynaRec 日志。
3: 启用详细级别的 DynaRec 日志。

BOX64_DYNAREC_MISSING

打印缺失的指令。在 WowBox64 中可用。

0: 不打印缺失的指令。 [默认值]
1: 打印缺失的指令。
2: 打印回退到标量指令的信息，仅对 RISC-V 有效。

BOX64_DYNAREC_NOHOSTEXT

禁用可选的主机扩展。

0: 不禁用任何扩展。 [默认值]
1: 禁用所有可选扩展。
xxx,yyy,zzz: 禁用指定的可选扩展，可选项包括 Arm：crc32,pmull,aes,atomics,sha1,sha2,uscat,flagm,flagm2,frintts,afp,rndr，LoongArch：lasx,lbt,frecipe,lam_bh,lamcas,scq，以及 RISC-V：zba,zbb,zbc,zbs,vector,xtheadba,xtheadbb,xtheadbs,xtheadmemidx,xtheadmempair,xtheadcondmov。

BOX64_DYNAREC_PERFMAP

为 Linux perf 工具生成映射文件。

0: DynaRec 不会生成 perf 映射。 [默认值]
1: DynaRec 将生成 perf 映射。

BOX64_DYNAREC_TEST

启用 DynaRec 与解释器的执行对比，非常慢，仅用于测试。在 WowBox64 中可用。

0: 不进行对比。 [默认值]
1: 每个指令都在解释器和 DynaRec 上运行，当寄存器或内存不同时进行对比并打印。
0xXXXXXXXX-0xYYYYYYYY: 定义 DynaRec 测试的范围（左闭右开）。

BOX64_DYNAREC_TEST_NODUP

启用 COSIM 发现差异的 IP 地址去重。在 WowBox64 中可用。

0: 显示所有出错的地址。 [默认值]
1: 每个出错地址仅显示一次，即使转储可能不同。

BOX64_DYNAREC_TEST_NODUMP

当 BOX64_DYNAREC_DUMP 启用时不转储测试代码。在 WowBox64 中可用。

0: 转储测试代码。
1: 不转储测试代码。 [默认值]

BOX64_DYNAREC_TRACE

启用或禁用 DynaRec 追踪。

0: 不追踪代码块。 [默认值]
1: 追踪代码块，会大幅降低程序速度并生成大量日志。

BOX64_JITGDB

发生 SIGSEGV、SIGILL 和 SIGBUS 时是否启动 gdb。

0: 捕获信号时仅打印消息。 [默认值]
1: 当捕获到 SIGSEGV、SIGILL 或 SIGBUS 信号时启动 gdb，附加到有问题的进程并进入无限循环等待。在 gdb 中，你需要自己找到正确的线程（在其堆栈中有 my_box64signalhandler 的线程），然后可能需要 finish 1 或 2 个函数（在 usleep(..) 内部），之后你将进入 my_box64signalhandler，就在 Segfault 消息的 printf 之前。然后 set waiting=0 退出无限循环。
2: 当捕获到 SIGSEGV、SIGILL 或 SIGBUS 信号时启动 gdbserver，附加到有问题的进程，并进入无限循环等待。使用 gdb /PATH/TO/box64 然后 target remote 127.0.0.1:1234 连接到 gdbserver（如果不在本机，则使用实际 IP）。之后的操作步骤与 BOX64_JITGDB=1 相同。
3: 当捕获到 SIGSEGV、SIGILL 或 SIGBUS 信号时启动 lldb，附加到有问题的进程并进入无限循环等待。