是否可通过Python编辑Maya错误模板自定义异常提示内容？

内置无raise错误输出方案 #

Maya 自带原生命令支持直接输出标准错误日志，不需要手动抛出异常：

• 调用maya.cmds.error()即可输出被脚本编辑器识别为错误级别的红色文本，支持传入多行字符串自定义内容。如果不需要触发代码中断、仅打印错误日志，可以搭配noContext=True参数避免触发默认的异常栈打印。
  示例代码：

from maya import cmds

error_title = "参数校验失败"
error_desc = "传入的顶点索引超出当前模型顶点范围，有效区间为0~1024"
# 仅打印自定义错误内容，不触发中断
cmds.error(f"{error_title}\n{error_desc}", noContext=True)

如果需要同时给用户弹出视口提示（不用切到脚本编辑器就能看到），可以配合cmds.inViewMessage()实现右上角浮窗提示：

cmds.inViewMessage(
    amg=f"<span style='color:#ff4d4f'>{error_title}</span><br>{error_desc}",
    pos="topRight",
    fade=True,
    fadeStayTime=5000
)

这个方案的缺点是默认不会自动打印调用栈，调试时没法快速定位报错位置，适合不需要中断执行的轻量提示场景。

自定义异常类实现可控报错模板 #

Python 原生支持自定义异常子类，完全可以根据需求定制错误输出格式，解决原生Exception重复打印标题、无法插入独立描述段的问题，同时保留Traceback调试能力，是自研工具场景下兼容性最高的方案：

import traceback
from maya import cmds

class ToolCustomError(Exception):
    def __init__(self, title: str, description: str = ""):
        self.title = title
        self.description = description
        # 先输出自定义格式的错误信息
        output_content = title
        if description:
            output_content += f"\n{description}"
        cmds.error(output_content, noContext=True)
        # 打印完整调用栈，保留调试信息
        traceback.print_exc()
        super().__init__(title)

# 调用示例
raise ToolCustomError(
    title="资产导入失败",
    description="检测到文件贴图路径包含中文/特殊字符，请将文件移动到纯英文路径后重试"
)

实现后的输出效果和预期完全一致：

• 第一行显示错误标题，第二行显示详细描述，均为错误级别的红色文本
• 后续输出完整Traceback调用栈
• 最后一行的异常类型提示仅显示标题，不会重复带出描述内容，排查分类时不会混淆
• 异常抛出后会正常中断后续代码执行，符合原生错误的行为逻辑

自定义错误提示样式 #

如果需要修改脚本编辑器中错误提示的颜色、格式，和Maya原生错误做区分，可以直接操作脚本编辑器控件实现：

1. 先获取当前脚本编辑器的输出控件引用

   se_panel = cmds.getPanel(scriptType="scriptEditorPanel")[0]
   se_output_ctrl = cmds.scriptEditorPanel(se_panel, q=True, outputControl=True)
   

2. 自定义错误文本颜色（RGB取值范围0~1）

   cmds.cmdScrollFieldExecuter(
       se_output_ctrl,
       e=True,
       errorTextColor=(1.0, 0.3, 0.1) # 改成橙红色，和Maya原生正红色错误做区分
   )
   

3. 如果需要插入带特殊格式的文本（比如分割线、加粗标签），可以直接调用控件的文本追加接口，指定内容和级别即可。

注意：不要随意修改全局sys.excepthook替换Maya原生异常处理逻辑，很容易和第三方插件、Maya内置功能的异常捕获冲突，自研工具范围内使用自定义异常类的方案不会影响全局逻辑，稳定性最高。

内容的提问来源于stack exchange，提问作者Jordan Dion-Duval