文件路径变量

MAYA_APP_DIR

此变量定义个人 Maya 应用程序目录。此目录包含项目和其他重要的项目：

  • 首选项目录
  • 项目目录
  • mayaRenderLog.txt
  • mayaLog
  • mayaJournal
  • 脚本目录
  • Maya.env，如果选择创建此项，则也可以位于此目录中
MAYA_APP_DIR 的默认位置为
平台 MAYA_APP_DIR 默认位置
Windows \Users\<用户名>\Documents\Maya
macOS $HOME/Library/Preferences/Autodesk/Maya
Linux $HOME/Maya

可以更改 MAYA_APP_DIR 的位置。可以在全局环境变量中设置它，也可以从终端或命令窗口中设置它。您无法在 Maya.env 中设置 MAYA_APP_DIR。如果在命令行或终端窗口中设置 MAYA_APP_DIR，则必须从同一窗口启动 Maya。

MAYA_ENV_DIR
设置此变量以从自定义位置而非 MAYA_APP_DIR/<Maya 版本>（默认位置）读取 Maya.env 文件。请参见从自定义位置读取 Maya.env。
MAYA_CMD_FILE_OUTPUT

此变量在启动时启用 cmdFileOutput 命令，使脚本辑器中的内容自动输出到指定文件。如果未指定文件名，则会将错误发送到标准错误输出，例如终端窗口。此功能有助于 Maya 在启动后发生崩溃时跟踪错误消息。

注：

“脚本编辑器”(Script editor)中的内容将同时在“脚本编辑器”(Script editor)中和指定的输出位置显示。

MAYA_CONTENT_PATH

此变量将获取内容目录的路径，使用这些路径可以填充内容浏览器中的“示例”(Examples)选项卡。通过将插件添加到其模块模板文件中的环境变量或使用 assetBrowser -addContentPath 标志，可以将插件及其自身的内容目录添加到此路径。

MAYA_CUSTOM_TEMPLATE_PATH

用于“属性编辑器”(Attribute Editor)时：该变量用于覆盖自定义“属性编辑器”(Attribute Editor)模板所在的目录。默认为 Maya 安装目录下的 scripts\AETemplates 文件夹。

用于“节点编辑器”(Node Editor)时：可以通过创建自定义属性列表模板自定义为每个节点显示的属性列表。下次创建相同节点时，Maya 会搜索现有模板，如果找到适用模板，则会使用您创建的自定义属性列表显示节点。您可以将此环境变量设置为自定义样板所在的位置，与其他用户共享这些模板。有关详细信息，请参见自定义节点属性列表。此环境变量支持在 Windows 上以 ; 分隔或在 Mac OS X/Linux 上以 : 分隔的多个路径。

MAYA_CUSTOM_TEMPLATE_WRITE_PATH

用于“节点编辑器”(Node Editor)。可以通过创建自定义属性列表模板自定义为每个节点显示的属性列表。默认情况下，模板保存到 $MAYA_APP_DIR/<app_ver>/[localized]/prefs/viewTemplates/，但您可以将此环境变量设置为所需的位置来覆盖默认位置。有关详细信息，请参见自定义节点属性列表。

MAYA_MODULE_PATH

定义 Maya 模块文件的搜索路径。模块文件是分发 Maya 插件的一种方式。有关详细信息，请参见 Maya 开发人员帮助中的分发 Maya 插件。

在 Maya.env 中添加到 MAYA_MODULE_PATH 的任何路径都将添加到搜索路径列表的前面。这意味着 Maya 将先在您指定的路径中搜索模块，然后再在默认模块路径中搜索这些模块。

平台 默认模块搜索路径
Windows

C:/Program Files/Autodesk/Maya<版本>/modules

C:/Users/<用户名>/Documents/maya/<版本>/modules

C:/Users/<用户名>/Documents/maya/modules

C:/Program Files/Common Files/Autodesk Shared/Modules/maya/<版本>

macOS

/Applications/Autodesk/maya<版本>/Maya.app/Contents/module

$HOME/Library/Preferences/Autodesk/maya/<版本>/modules

$HOME/Library/Preferences/Autodesk/maya/modules

/Users/Shared/Autodesk/modules/maya/<版本>

/Users/Shared/Autodesk/modules/maya

Linux

/usr/autodesk/maya<版本>/modules

$HOME/maya/<版本>/modules

$HOME/maya/modules

/usr/autodesk/modules/maya/<版本>

/usr/autodesk/modules/maya

注：

如果在创建的文件路径中使用空格，在访问存储在该目录中的图标图像文件时可能会出错，因为该文件路径不会在 Maya 中显示。可通过仅指定不包含空格的文件路径来避免此问题。

MAYA_MOVIE_DIR

此变量用于覆盖存储电影文件的目录。默认值为 $MAYA_LOCATION/movies。

MAYA_LOCATION

Maya 安装目录的路径。如果未设置此变量，则会使用默认 /usr/autodesk/MayaVersionNumber (Linux) 或 C:\Program Files\Autodesk \MayaVersionNumber (Windows)。

在 macOS 中，Maya 会安装为 /Applications/Maya <版本>/Maya.app。由于 macOS 架构使得访问 Maya 应用程序软件包的内容变得十分困难，因此强烈建议不要在 macOS 上使用 MAYA_LOCATION。请改用以下备用位置：

MAYA_PACKAGE_PATH
使用此变量可以将非标准位置的目录包含在 Autodesk App Store 中 Maya 模块文件的默认搜索路径中，例如 Maya bonusTools。
Maya 对搜索的每个平台使用一组不同的路径。
  • Windows/Linux：…./Autodesk/ApplicationPlugins
  • macOS：…./Autodesk/ApplicationsAddins

设置此变量会将指定路径置于搜索顺序中的首位。与 Autoloader 插件一起使用。

MAYA_PLUG_IN_PATH

搜索插件的路径。当以相应路径名称指定插件时，即会在此路径的目录中搜索指定插件的名称。此路径还会确定列在“插件管理器”(Plug-in Manager)中的目录。此外，对于 Maya 启动时发现的每个模块文件，该模块根目录下的 plug-ins 子目录将添加到 MAYA_PLUG_IN_PATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述以及 Maya 开发人员帮助中的“分发多文件模块”部分。

Windows 的默认值

<用户的目录>/Documents/Maya/<版本>/plug-ins

<用户的目录>/Documents/Maya/plug-ins

<maya_directory>/bin/plug-ins

macOS 的默认设置

在主文件夹下的 Library/Preferences/Autodesk/Maya/<版本>/plug-ins 中

在主文件夹下的 Library/Preferences/Autodesk/Maya/plug-ins 中

/Users/Shared/Autodesk/Maya/<版本>/plug-ins

/Users/Shared/Autodesk/Maya/plug-ins

在 /Applications/Maya <版本>/Maya.app 中的 Maya 软件包内

Linux 的默认值

$MAYA_APP_DIR/Maya/<版本>/plug-ins

$MAYA_APP_DIR/Maya/plug-ins

/usr/autodesk/userconfig/Maya/<版本>/plug-ins

/usr/autodesk/userconfig/Maya/plug-ins

$MAYA_LOCATION/bin/plug-ins

注：

当向 MAYA_PLUG_IN_PATH 环境变量添加多个路径时，Mac OS X 中必须使用 :（冒号）分隔路径，Windows 和 Linux 中必须使用 ;（分号）分隔路径。

MAYA_PRESET_PATH

定义 Maya 预设的位置。路径中的每个条目指向 attrPresets 目录之上的目录。此外，对于 Maya 启动时发现的每个模块文件，模块根目录中的“预设”子目录将添加到 MAYA_PRESET_PATH。有关详细信息，请参见上述 MAYA_MODULE_PATH 变量的描述以及 Maya 开发人员帮助中的“分发多文件模块”部分。

MAYA_PROJECT

指定启动时项目文件夹的位置。

在“首选项”(Preferences)窗口中的“文件/项目 > 项目设置”(File/Projects > Project Settings)下，文件夹位置显示为“始终使用此项目启动”(Always start in this project)。设置变量后，将无法从“首选项”(Preferences)窗口中更改项目文件夹的位置。必须更改或删除变量。

MAYA_PROJECTS_DIR

指定项目文件夹的位置。

在“首选项”(Preferences)窗口中，“文件项目 > 项目设置”(File/Projects > Project Settings)下，文件夹位置显示为“默认项目目录”(Default projects directory)。设置变量后，将无法从“首选项”(Preferences)窗口中更改项目文件夹的位置。必须更改或删除变量。

MAYA_SHELF_PATH

指定 Maya 为了访问工具架而对其进行搜索的目录。可以将工具架存储在不同组可访问的位置，然后这些组将设置各自工作站的 MAYA_SHELF_PATH 变量。

可以使用 MAYA_SHELF_PATH 指定多个目录并用冒号分隔；例如，Production/shelf:Shot/shelf:MyDir/shelf 指定三个不同的工具架目录。Maya 会在启动时按指定顺序搜索每个目录以实例化工具架。在搜索 MAYA_SHELF_PATH 中指定的目录后，Maya 将继续从默认工具架目录添加工具架。一个工具架一旦存在，后续搜索目录中具有相同名称的工具架将被忽略。

新建工具架将始终存储在默认工具架目录中。若要共享工具架，请将其移动到所需目录（即 MAYA_SHELF_PATH 指定的目录之一）。

若要限制对工具架目录的访问权限，请禁用该目录的写入权限。如果用户在退出或保存所有工具架时尝试写入受限工具架目录，系统即会显示警告。

MAYA_SCRIPT_PATH

以逗号分隔的 MEL 脚本搜索路径。如果调用未解析的 MEL 程序，则将在此路径中搜索实施该程序的脚本。此外，如果在不提供完整路径的情况下寻找 MEL 文件的来源，则也将搜索该路径。

此外，对于 Maya 启动时发现的每个模块文件，该模块根目录下的 scripts 子目录将添加到 MAYA_SCRIPT_PATH。请参见上述 MAYA_MODULE_PATH 变量的说明。

注意： 如果选择定义自定义脚本路径和自定义工具架路径（即，设置 MAYA_SHELF_PATH 和 MAYA_SCRIPT_PATH），则 MAYA_SHELF_PATH 必须先（早于 MAYA_SCRIPT_PATH）在 Maya.env 中列出。
MAYA_TOOLCLIPS_PATH

指定 Maya 将搜索工具动画演示内容的目录。

可以使用 MAYA_TOOLCLIPS_PATH 并用冒号分隔来指定多个目录；例如，<drive:>\<path>;<drive2:>\<path2> 指定了两个不同的工具动画演示目录。启动时，Maya 会按指定顺序搜索每个目录。搜索完 MAYA_TOOLCLIPS_PATH 中所指定的目录之后，Maya 会继续依次搜索默认的 user.toolclips 目录和 builtin.toolclips 目录。

如果某一关键帧名称存在于工具动画演示搜索路径内的两个 ToolClip.xml 文件中，Maya 会使用首先出现的关键帧名称。

PYTHONPATH

定义 Python 库文件的位置。

在启动 Maya 之前，将您要在 Python 脚本中使用的任何外部库添加到此环境变量。

在 PYTHONPATH 启动时，Maya 会对 PYTHONPATH 进行设置。为 PYTHONPATH 指定的路径将添加到由 Maya 设置的路径列表的前面，这意味着将先搜索这些路径，再搜索 Maya 自己的目录。

可以在 Maya.env 或在系统级别设置 PYTHONPATH。如果 PYTHONPATH 是在系统级别设置的，则在 Maya.env 中设置 PYTHONPATH 将不起作用。

有关详细信息，请参见将外部 Python 库 与Maya Python 结合使用。

XBMLANGPATH

此变量指定图标文件的位置，包括用于“工具架”(Shelf)按钮的图标。

设置 XBMLANGPATH 时，指定的路径将添加到已经由 Maya 设置的路径列表的前面，这意味着将先搜索这些路径，再搜索 Maya 自己的目录。