常规变量

MAYA_ALIAS_LICENSE_TIMEOUT

恢复上一个许可行为（尝试恢复丢失的许可）将持续 15 分钟，而不是默认的 Autodesk 标准两个小时。

MAYA_ALLOW_REFERENCED_CAMERA_SEQUENCER

有时，在场景中创建的镜头会连接到被引用文件中的摄影机序列器节点。这种行为已得到更正。使用此选项可还原以前的行为。

若要启用该选项，请将该值设定为 1。若要禁用它，请使其保留未定义。

MAYA_CACHE_DISABLE_TIME_EDITOR

将值设置为 1，可在加载包含时间编辑器片段的场景时，让缓存播放(Cached Playback)进入安全模式（黄色警告状态）。有关安全模式的详细信息，请参见“缓存播放”(Cached Playback)状态行的状态。

MAYA_DEBUG_CORE_ON_CRASH（仅限 Linux 和 macOS）

设置此环境变量后，如果 Maya 崩溃，将生成核心转储 (Linux) 或 Apple 崩溃报告 (macOS)。

若要启用此选项，请将其设置为 1。若要禁用此选项，请将其设置为 0，或者将其保留为未定义。

在 Linux 上，必须设定 ulimit 设置才能生成核心文件。如果未设定该设置以生成核心文件，请运行：

ulimit -c unlimited

平台	核心文件名称和位置
Linux	core.pid（位于 Maya 的工作目录中）
macOS	Maya_<timestamp>.ips（位于 ~/Library/Logs/DiagnosticReports 或 /Library/Logs/DiagnosticReports 中）

MAYA_DEBUG_ENABLE_CRASH_REPORTING（仅限 Windows 和 Linux）

Maya 遇到致命错误时，该变量会将故障报告文件 (MayaCrashLog[yymmdd.hhmm].log) 写入到使用 TMP 环境变量指定的目录中。该文件包含发生故障时 Maya 执行的操作的详细描述。

若要启用该选项，请将该值设定为 1。若要禁用该选项，请将该值设定为 0（零），或保留其未定义。

MAYA_DEBUG_SIGTERM_AS_SIGINT（Windows 和 Linux）

通常，当 SIGTERM 信号发送到 Maya 的信号处理程序时，它会尝试保存场景并生成崩溃报告。将此变量设置为值 1 时，会导致 Maya 立即中断，而不执行这些步骤。

若要启用该选项，请将该值设定为 1。若要禁用该选项，请将该值设定为 0（零），或保留其未定义。

MAYA_DET_TANGENT

默认情况下，切线计算是多线程的。但是，这将在结果中引入少量差异。启用此变量可以移除差异，以确保确定的切线值，但这会降低性能。

若要启用该选项，请将该值设定为 1。若要禁用该选项，请将该值设定为 0（零），或保留其未定义。

MAYA_DISABLE_ADP

将此环境变量设置为 1，可在以批处理模式启动 Maya 时选择退出分析。

MAYA_DISABLE_BACKSPACE_DELETE（Windows 和 Linux）

禁用 Backspace 键的功能。若要启用该选项，请将该值设定为 1。若要禁用该选项，请将该值设定为 0（零），或保留其未定义。

MAYA_DISABLE_LOD_VISIBILITY

将此环境变量设置为 1 时，可阻止解算管理器(Evaluation Manager)在每次 LODVisibility 属性更改时重建解算图。

此变量解决了包含许多 LOD 组的场景的性能问题，因为只要移动摄影机，这些场景就会触发图表重新划分。

MAYA_DISABLE_PACKED_MULTI_ATTRIBUTES

此变量禁止将多重-多重属性的属性数据压缩成块。启用压缩后，某些数据类型的文件大小变小且加载/保存时间缩短。例如，具有类似 skinCluster.weightList[].weights[] 属性结构的蒙皮权重，存储每个顶点、每个影响的权重。

压缩的块组合 setAttr 命令来设置父级多重属性中的范围值，例如 setAttr skinCluster.weightList[0:122].weights 4 1 2 3 4 4 5 6 7 8 4 8 9 10 11，这会显著减少文件中此类数据所需的 setAttr 命令数。

以前，此变量在 mayaAscii 或 mayaBinary 文件中为 weightList 中的每个元素创建一个 setAttr 命令，该命令将为单个顶点设置权重。这些命令会有少量的影响/值，例如：setAttr skinCluster.weightList[123].weights 1 2 3 4。

但是，此变量为大量顶点生成了大量 setAttr 命令。这一点适用于场景中任何具备此多重-多重结构的属性，而不仅仅是 skinCluster 权重。

每次保存文件时都会应用此变量，因此，无需重新启动 Maya 即可动态更改行为。

注： 2017 之前的 Maya 版本无法识别此压缩格式。如果需要在 2017 之前的 Maya 版本中打开使用此变量的文件，请先设置该变量并保存文件而不进行压缩，然后在先前版本中将其打开。否则，该文件将无法正确加载。

设置以下值：

1 - 禁用属性数据压缩

空 - 重新启用该变量（还可以从环境中删除该变量）

例如：

import os

del os.environ["MAYA_DISABLE_PACKED_MULTI_ATTRIBUTES"]

# or

os.environ["MAYA_DISABLE_PACKED_MULTI_ATTRIBUTES"] = ""

MAYA_ENABLE_MULTI_DRAW_CONSOLIDATION

在视口中进行绘制时，通过将适用于静态对象的传统整合与适用于非变形动画对象（包括网格、NURBS 曲面、NURBS 曲线和其他几何体）的多图形整合相结合，可以提高视口性能。

默认情况下，此环境变量处于启用状态 (MAYA_ENABLE_MULTI_DRAW_CONSOLIDATION=2)。

按如下所示设置其他值：

0 - 仅传统静态对象整合

1 - 静态对象和动画对象多图形整合

注： 受支持的最新 Linux 和 Windows GPU 硬件及驱动程序支持多图形整合。有关详细信息，请参见“Maya 硬件认证”(Maya Hardware Certification)图表。

由于 Mac OS X 上缺少图形堆栈支持，因此多图形整合不可用

MAYA_FORCE_REF_READ

默认情况下，如果多次引用某文件，则 Maya 仅在第一次引用时从磁盘读取该文件。在处理对该文件的后续引用时，Maya 复制最初读取时的现有场景信息，而不是从磁盘重新读取文件。如此处理文件引用可优化性能。有时，这种多次引用优化功能会导致出现错误。

设置 MAYA_FORCE_REF_READ 环境变量会禁用文件引用优化功能，并会强制从磁盘显式读取所有引用文件。在某些情况下这可以修复 Maya 的行为以避免发生解算错误，但同时会降低性能。

MAYA_FBX_LOG_FILENAME

设置此环境变量，以将 FBX 日志文件重命名为此变量指定的字符串：MAYA_FBX_LOG_FILENAME=<customstring>，其中 <customstring> 是日志文件的首选名称。

在此处查找日志文件：${MAYA_APP_DIR}/FBX/Logs/version/<customstring>.log。请参见 FBX 导出选项主题中的生成日志数据(Generate log data)。

注： 此方法将创建一个文件。如果日志文件锁定，导致其他导入/导出进程无法访问日志，请使用 MAYA_FBX_LOG_DATETIME_ISO（下文）生成两个单独的日志文件。

MAYA_FBX_LOG_DATETIME_ISO

创建单独的 FBX 日志文件以用于导入或导出，并使用当前日期和时间作为这些日志文件的时间戳：${MAYA_APP_DIR}/FBX/Logs/2020.3.2/maya2024imp_20230721T153409.log

MAYA_MULTI_SKIN_CLUSTER

控制是否允许多个蒙皮簇。

默认情况下，必须设置为“1”以便允许使用多个蒙皮簇。

传递给 skinCluster -multi 命令的值将优先于默认值。

MAYA_NO_HOME

用于绕过应用程序主页(Application Home)屏幕，直接进入 Maya 用户界面。此环境变量与界面首选项(Interface Preferences)中的“启动时显示主屏幕”(Show Home Screen on startup)选项相同。

默认情况下，此环境变量处于禁用状态 (MAYA_NO_HOME=0)。

按如下所示设置其他值：

1 - 启动 Maya 时跳过应用程序主页(Application Home)屏幕，直接启动到工作区。

MAYA_NO_HOME_ICON

用于隐藏显示在菜单栏旁边的“主页”(Home)图标 。这有助于防止意外切换到应用程序主页(Application Home)屏幕。此环境变量与界面首选项(Interface Preferences)中的“在菜单栏中显示主页图标”(Show Home icon in menu bar)选项相同。

默认情况下，此环境变量处于禁用状态 (MAYA_NO_HOME_ICON=0)。

按如下所示设置其他值：

1 - 隐藏“主页”(Home)图标 ，并将菜单重新定位到其默认位置。

注： 激活此选项（将环境变量设置为 1）也会抑制随“主页”(Home)图标一起显示的崩溃恢复消息。这些消息将显示在脚本编辑器(Script Editor)中。

MAYA_NO_WARNING_FOR_MISSING_DEFAULT_RENDERER

用于抑制有关 Arnold 渲染器（MtoA 插件）的错误消息。

1 - 隐藏错误消息

MAYA_PARALLEL_MEMCPY

将该环境变量设定为 1 可启用并行内存复制。在某些情况下，并行内存复制在基于 Opteron 和 Nehalem 的系统上会更快。但是，在 Xeon 系统上并行内存复制还可能会更慢，在这种情况下，可能会希望禁用并行内存。

注：

另一个可能会影响速度的因素是正在 Maya 中运行的工作量。

MAYA_IP_TYPE

使用该环境变量可设置 IP 版本，例如，IPv4。

MAYA_HELP_URL

该变量用于覆盖帮助文件所在的位置。Maya 会将该值预先附加到其帮助路径中，以创建传递给浏览器的字符串。

可以使用该变量将 Maya 指向中心帮助服务器，或者将它设定为一个 http: URL 以让 Maya 从 Web 站点获取其帮助文件，而不是从硬盘驱动器上的 Maya 帮助获取。

不正确使用该标志将阻止“Maya 帮助”(Maya Help)在 Maya 内正常运行。

MAYA_OVERRIDE_UI

如果已设置该环境变量，那么 Maya 将不会加载文件 initialLayout.mel，该文件会创建界面。必须指定要运行的替代文件（例如，MAYA_OVERRIDE_UI = test.mel）。仅当要使用自己的自定义编程接口完全替换 Maya 的 UI人时，才应指定该变量。

MAYA_PAINT_EFFECTS_THREADS

在绘制和渲染时，Paint Effects 使用计算机上的多个处理器。可以设置该变量来控制 Maya 所使用的处理器数量。最小值为一个 (1)，最大值为三个 (3)。

WINEDITOR（Windows、Linux）

使用该变量可以覆盖“表达式编辑器”(Expression Editor)并使用自己的编辑器。必须将该编辑器设定为在前景中运行。

MAYA_SCRIPT_EDITOR_STDOUT

设置此环境变量后，“脚本编辑器”(Script Editor)的输出将在 Windows 上的 Maya 输出窗口中镜像，并在 Linux 和 macOS 上的 stdout 中镜像。

默认情况下，此选项处于禁用状态。若要启用此选项，请将其设置为 1。若要在设置此环境变量后将其禁用，请将其设置为 0。

MAYA_UI_LANGUAGE（Windows、macOS）

如果设置为 en_US，Maya 将采用英语运行，而不考虑操作系统所使用的语言。

若要在 Windows 上将 Maya 恢复为采用其默认语言，请从环境变量中删除 MAYA_UI_LANGUAGE。

若要在 macOS 上将 Maya 恢复为采用其默认语言，请使用 unset MAYA_UI_LANGUAGE。

注： 默认情况下，Maya 将采用英语、日语或简体中文运行，具体取决于操作系统的语言。

有关详细信息，请参见在日语或简体中文环境中采用英语运行 Maya。

MAYA_DISALLOW_DUPLICATE_ATTRIBUTE_NAMES

该环境变量在未设置时会被禁用。将其设定为任何字符串可启用它。默认情况下会禁用该环境变量。

在 Maya 2011 和更低版本中，不存在任何显式测试来确保属性名称在节点内是唯一的。使用诸如 setAttr NODE.DUPLICATED_ATTR 3.0 之类的命令时，这可能会导致不明确。某些现有脚本、文件和/或插件可能会依赖于该不明确的行为；因此，为了向后兼容，在 Maya 2012 中引入了该环境变量。但是，我们鼓励用户停止该不明确的行为。

MAYA_USE_ALTERNATE_UNFOLD_SHIM

如果尝试在 Maya 2022 之前的版本中展开对象时收到“Unfold3d 进程错误”(Unfold 3d Process Error)消息，请将此变量设置为 1。

此错误是由 AMD Ryzen 处理器限制引起的，已在 Maya v.2022 中得到解决。

还可以选择

• 使用 UV 编辑器(UV Editor)中的展开方向:旧版算法设置。另请参见展开 UV 网格。
• 在 BIOS 中禁用 Ryzen 品牌 SMT（同步多线程开关）。

MAYA_USE_MALLOC

如果在加载大型场景时 Maya 遇到问题而意外关闭，请尝试将此环境变量设置为 1。但是，如果设置此环境变量，则在选择“文件 > 新建”(File > New)时 Maya 不会释放使用的内存；只在退出 Maya 时释放。

MAYA_USE_VARYING_INT

如果希望在 Viewport 2.0 中显示较大的组件 ID 号 (>16777216)，则必须使用支持几何体着色器的整数变化输入的显卡；此外，还要将该环境变量设置为 1。

MAYA_DISABLE_CASCADING

将该环境变量设置为任何值，以针对 Maya 禁用许可证级联。

MAYA_CER_INCLUDE_SCENE_NAME

使用此环境变量来确定是否将场景文件名包含在提交给 Autodesk 的 CER 报告中。如果未设置此变量，场景名称将显示为“未公开”。

• 0 = 场景名称以非公开形式列出
• 1 = 仅包含文件名
• 2 = 包含完整路径/文件名

MAYA_FORCE_PANEL_FOCUS

将此环境变量设置为 0，以在将 Maya 或 Qt 窗口移至带模型面板的其他窗口（或“大纲视图”(Outliner)、“曲线图编辑器”(Graph Editor)等窗口或“面板 > 面板”(Panels > Panel)下的任意面板）上方时，按下 Shift 键不会导致模型面板的窗口强行获得焦点。

此变量的默认值为 1。

将此环境变量设置为 0 时，单击热键仅会影响具有焦点的工作区。如果要对其他工作区使用热键，您可能需要单击该工作区，以在热键生效之前将焦点移到该区域。

MAYA_ENABLE_NG_CONSOLE_STATS

在 Maya 2013 中，“节点编辑器”(Node Editor)在默认情况下将显示统计信息（节点、连接、边、样例代理，FPS、缩放）。目前，默认情况下不显示统计信息，您可以通过将环境变量 MAYA_ENABLE_NG_CONSOLE_STATS 设置为 1 来查看这些信息。

MAYA_LOCK_FOREGROUND_WINDOW

将此变量设置为 1 会将 Maya 命令窗口锁定到显示的前景。

这在运行 Maya API 独立应用程序时十分有用。此类应用程序可能会从 Maya 命令窗口中强行获取光标焦点，并导致很难退出正在运行的应用程序。

MAYA_DISABLE_PLUGIN_SCENE_MODIFIED_WARNING

默认情况下，如果加载导致场景更改的插件，将会出现一条警告，内容为：“加载插件 Plug-inName 已导致场景更改，可能需要保存更改。”

若要禁用此警告，请将 MAYA_DISABLE_PLUGIN_SCENE_MODIFIED_WARNING 设置为 1。

MAYA_ENABLE_LEGACY_INCORRECT_NODE_NAMES

以前，Maya 将在创建和重命名节点时接受非法名称；例如，ns:0abc。从 Maya 2015 开始，非法节点名称将不再有效。每次使用非法节点名称打开、引用或导入场景时，将显示一个对话框，通知您更新场景并更正非法节点名称。

若要对当前 Maya 会话禁用该对话框，请启用该复选框。若要永久禁用该对话框，请将此环境变量设置为 1。

若要列出所有包含非法名称的节点，请执行命令 listNodesWithIncorrectNames。

有关详细信息，请参见非法节点名称疑难解答。

MAYA_SKIP_BLOCK_CHECK

将此变量设置为 1 可在退出时跳过检查 STDIN 模式。Maya 将退出，而无需等待 STDIN 返回到“阻塞”(BLOCKING)状态。

MAYA_PYTHON_USER_PACKAGES_PRIORITY

设置此变量以在启动时在 Maya 自己的 Python 库之前加载用户站点目录 Python 库。

如果未设置此变量，则将在任何用户站点目录 Python 库之前加载 Maya 的 Python 库。

在 Maya 自己的库之前加载外部 Python 库可能会导致意外行为，包括 Maya 在启动时崩溃。

MAYA_WRITE_HIK_V1

如果设置为“1”，则 Maya 会在从 HumanIK 菜单导出角色定义时尝试写出版本 1 的 .hikc 角色定义文件。如果角色中存在以版本 2 的 .hikc 格式引入的其他关节，则将失败。如果角色定义文件需要与旧版 HumanIK Gameware 产品兼容，则此变量非常有用。

MAYA_USER_CER_APP (Windows)

通过执行以下操作，可以从 Maya 获取崩溃错误报告：

1. 编写您自己的自定义可执行文件，用于处理此数据（例如，您可能需要将 CER 数据写入文件，或通过电子邮件将其发送给用户列表）。
2. 将 MAYA_USER_CER_APP 环境变量设置为您自己的自定义可执行文件的路径。

Maya 将提供必要的命令行参数，以便在发生崩溃时调用自定义可执行文件，就像使用其自己的“本地”senddmp 可执行文件一样。

您可以在 Maya 安装的 \bin 目录中找到 senddmp.exe。

注：

提示：您可以使用 Python 实现自定义 CER 处理程序，将其另存为 .py 文件，然后按如下方式设置环境变量：

MAYA_USER_CER_APP=python.exe A:\path\to\custom_cer_handler.py

此功能仅适用于 Windows。

MAYA_AUTOSEND_CER (Windows)

可以通过填充环境变量来自动发送崩溃错误报告。

使用 CER 的电子邮件地址字符串设置 MAYA_AUTOSEND_CER 变量。这将跳过 CER 对话框，并自动将 CER 发送给 Autodesk。

MAYA_AUTOSEND_CER_DESCRIPTION (Windows)

如果已启用自动发送崩溃错误报告，则可以通过将 MAYA_AUTOSEND_CER_DESCRIPTION 设置为字符串值来填充 CER 的描述字段。如果未启用 MAYA_AUTOSEND_CER，则此项不起作用。如果已在使用自定义崩溃处理程序来跟踪自己的数据集中的崩溃，这将非常有用。您可以在此处存储每个 Maya 会话的 GUID 或会话 ID，然后您自己的自定义崩溃处理程序和 Autodesk CER 将自动接收相同的 ID 号，以便轻松传达崩溃报告的状态和进度。

MAYA_SECURE_OPTOUT

当设置为“1”时，Maya 将忽略显示所有安全相关对话框（但仍在 .log 文件中记录安全事件）。