在 maya 2022 中开发可分发插件时，应避免硬编码绝对路径；推荐通过 __file__ 动态计算相对于脚本文件的资源路径，或采用 maya 模块（module）机制实现跨平台、可移植的资源加载。
在 maya 2022 中开发可分发插件时，应避免硬编码绝对路径；推荐通过 __file__ 动态计算相对于脚本文件的资源路径，或采用 maya 模块（module）机制实现跨平台、可移植的资源加载。
在 Maya 工具开发中，将图标、UI 文件或配置资源路径写死为类似 "C:/example/path/here/example.png" 的绝对路径，会严重阻碍工具的共享与部署——其他用户因路径不一致导致资源加载失败，调试困难且维护成本高。以下是两种经过实践验证的可靠方案：
✅ 方案一：基于 file 的动态相对路径（推荐入门 & 快速部署）
利用 Python 内置的 file 属性获取当前脚本的完整路径，再结合 os.path 或更现代的 pathlib 构建稳定相对路径。这是最轻量、无需修改 Maya 环境即可立即生效的方式。
import os
from pathlib import Path
# 获取当前脚本所在目录
script_dir = Path(__file__).parent.resolve()
# 假设图标存放在脚本同级的 'icons' 文件夹中
icon_path = script_dir / "icons" / "example.png"
# 或者存放在上一级目录的 'resources/icons'
# icon_path = script_dir.parent / "resources" / "icons" / "example.png"
# 转为字符串供 Maya UI 使用（如 QIcon.setPixmap）
icon_str = str(icon_path)
print(f"Resolved icon path: {icon_str}")
# 输出示例：D:/my_tool/icons/example.png（自动适配 Windows/macOS/Linux）
✅ 优势：
- 无需改动 Maya 环境变量或脚本路径；
- 支持跨平台（pathlib 自动处理路径分隔符）；
- 项目结构清晰（如：my_tool/init.py, my_tool/icons/, my_tool/ui/）；
- 可直接打包为 ZIP 分发，用户解压即用。
⚠️ 注意事项：
- 确保图标文件实际存在于预期相对位置；
- 避免在 Maya 启动时未加载脚本就调用路径（如放在 Shelf 按钮中需确保脚本已导入）；
- 若使用 PySide2/6 加载图片，建议添加存在性检查：
if not icon_path.exists():
raise FileNotFoundError(f"Icon not found: {icon_path}")
✅ 方案二：Maya 模块（Module）机制（推荐专业分发 & 多工具集成）
当工具需长期维护、多模块协作或集成到公司管线时，应采用 Maya 官方推荐的模块系统。创建 maya/modules/ 下的 .mod 文件，Maya 会在启动时自动注册其 scripts 和 icons 子目录为搜索路径。
示例模块结构：
C:/MyTools/
├── my_tool.mod ← 模块定义文件
├── scripts/
│ └── my_tool.py
└── icons/
└── example.png
my_tool.mod 内容：
+ MAYAVERSION:2022 my_tool 1.0 ./ scripts: scripts icons: icons
✅ 优势：
- Maya 自动识别并优先搜索模块内的 icons/ 目录（例如 cmds.iconTextButton(image="example.png") 可直接使用文件名）；
- 支持版本控制与多工具共存；
- 无需在代码中拼接路径，提升可读性与鲁棒性；
- 便于通过 MAYA_MODULE_PATH 批量管理多个工具集。
? 启用方式：
将模块根目录（如 C:/MyTools）添加到环境变量 MAYA_MODULE_PATH，重启 Maya 即可生效。
? 总结建议
- 个人小工具 / 快速原型 → 优先使用 Path(file).parent + pathlib；
- 团队级工具 / 生产管线 / 多版本支持 → 必须采用 Maya Module 方式；
- 切勿依赖 os.environ["MAYA_SCRIPT_PATH"] 或硬编码 users/{username}/ 路径——这极易引发权限、路径空格、跨平台兼容等问题；
- 所有路径操作务必加入存在性校验与异常提示，提升用户体验与调试效率。
