Maya Python脚本报No module named：模块路径与Python版本排查
问题概述：脚本在一台机器能运行，换版本后提示找不到模块。
这类问题最容易被“反复重启、盲目加采样或直接删除节点”掩盖。可靠的处理方式是先复制工程，在可回退的副本中建立最小测试，再一次只改变一个变量。
常见原因
- Maya内置Python主版本变化
- 模块没有放在 sys.path
- 第三方包含不兼容二进制扩展
- MAYA_MODULE_PATH配置错误
推荐解决步骤
- 在 Script Editor 输出 sys.version 和 sys.path
- 优先使用 Maya module 文件管理工具路径
- 纯Python包可放到版本对应的 scripts/site-packages
- 含二进制扩展的包必须匹配 Maya Python 与平台
- 避免把系统Python包目录直接混入Maya
如何确认已经修好
重启 Maya 后无需手工 append 路径即可导入模块，且不同用户环境结果一致。
容易踩的坑
不要在唯一工程文件上直接清理、解绑或覆盖保存；不要同时修改多个设置，否则即使结果变好，也无法知道真正起作用的是哪一步。涉及插件、渲染器和颜色管理时，还应记录 Maya 版本、插件版本、操作系统和项目单位。
官方参考
菜单名称和默认值可能随版本变化，可结合 Autodesk Maya 官方帮助核对当前版本。
本文为喵喵动画屋整理的实战排错清单。建议先在副本中测试，再应用到正式项目。
