如何用一行Python代码抛出带备注信息的RuntimeError异常？

期望的异常输出 #

RuntimeError: Unable to parse Powershell-encoded commands.
was a `{$...}` left in the command?

Process finished with exit code 1

理想的简洁实现代码 #

我希望用更简洁的写法实现上述输出，比如：

if sys.argv[1] == '-encodedCommand':
    raise RuntimeError("Unable to parse Powershell-encoded commands.").with_note('was a `{$...}` left in the command?')

当前的实现方式（不够简洁） #

目前能实现需求但写法繁琐的代码如下：

if sys.argv[1] == '-encodedCommand':
    to_raise = RuntimeError("Unable to parse Powershell-encoded commands.")
    to_raise.add_note('was a `{$...}` left in the command?')
    raise to_raise

选择异常备注的原因 #

我刻意将核心错误信息放在异常消息中，辅助排障提示放在备注里：

• 核心消息“Unable to parse Powershell-encoded commands.”是问题的本质，属于异常的核心内容
• 提示“was a {$...} left in the command?”只是帮助排查问题的补充信息，用备注区分能让异常结构更清晰

异常消息的最佳实践 #

• 核心优先：异常主消息必须直接点明错误本质，让开发者快速定位问题类型
• 分层补充：排障线索、可能诱因这类非核心信息，适合放在异常备注中（Python 3.11及以上版本支持add_note()和with_note()方法），避免主消息冗长杂乱
• 简洁精准：主消息避免冗余表述，尽可能提供具体的错误指向，比如这里明确提到{$...}格式问题
• 可读性优先：确保异常信息整体结构清晰，核心与辅助信息区分明确，便于调试和问题定位

内容的提问来源于stack exchange，提问作者Daniel Lawson