MayaSublime 开源项目安装与使用指南

MayaSublime 是一个专为 Sublime Text 用户设计的插件，它使用户能够便捷地将选中的 MEL 或 Python 代码片段发送到运行中的 Maya 环境中执行，极大地提高了开发效率。以下是关于该开源项目的关键组成部分——目录结构、启动与配置文件的详细介绍。

1. 项目目录结构及介绍

MayaSublime 的项目结构简洁明了，典型的 Python 包布局，包含必要的组件：

• 主目录
  • MayaSublime.py: 核心脚本，负责实现代码的发送逻辑。
  • MayaSublime.sublime-settings: 配置文件，用于设置默认参数，如命令端口和是否接收Maya输出等。
  • Default (Windows).sublime-keymap, Default (Linux).sublime-keymap, Default (OSX).sublime-keymap: 不同操作系统的默认快捷键绑定文件。
  • README.md: 项目简介和快速入门指导。
  • LICENSE: 许可协议文件。
  • 可能还包括其他辅助文件或子目录来支持插件的不同功能和资源。

2. 项目的启动文件介绍

虽然 MayaSublime 并没有传统意义上的“启动文件”，其激活与运行依赖于 Sublime Text 的环境。安装完成后，启动 Sublime Text 即自动启用此插件。核心功能触发主要通过用户操作，比如选中代码并使用预设的快捷键（默认为 Ctrl+Return）或者通过右键菜单选择“Send To Maya”。

3. 项目的配置文件介绍

MayaSublime.sublime-settings

这是关键的配置文件，用户可以在此定制插件的行为：

• 基础配置:

  • "port": 设置与 Maya 建立命令端口通信的默认端口号。
  • "receive_maya_output": 控制是否开启从 Maya 脚本编辑器接收输出的功能，默认为 false，可根据需求改为 true 来实现在 Sublime Text 内查看 May输出。

• 高级自定义:

  • 你可以调整默认快捷键、增加或修改命令端口、以及控制其他行为设置，以符合个人工作流。

为了应用更改，用户应该在 Sublime Text 中进行配置修改，通常建议在用户设置中覆盖默认设置，而不是直接修改默认设置文件，以防止更新时丢失个性化配置。

如何访问配置：

• 在 Sublime Text 中，通过菜单选择 Preferences > Package Settings > MayaSublime > Settings - User 来查看或编辑个性化的设置。

遵循以上指南，开发者可以高效地集成 MayaSublime 到他们的日常工作中，无缝桥接 Sublime Text 编辑器与 Maya 之间的交互，提升工作效率。