我应该何时声明自定义例外？

Question

我想引发一些异常，这些异常传递一些消息和与错误相关的值。我想知道什么时候声明自定义异常比使用内置异常更合适。你知道吗

我见过很多类似this的例子，还有很多类似的例子被推荐到其他网站上。你知道吗

class NameTooShortError(ValueError):
    pass

def validate(name):
    if len(name) < 10:
        raise NameTooShortError(name)

我更倾向于编写代码，例如：

def validate(name):
    if len(name) < 10:
        raise ValueError(f"Name too short: {name}")

我的直觉是，只有当复杂或特定的信息需要存储在异常实例中时，才会声明自定义异常。声明空类在我看来是错误的。你知道吗

Answer 1

正在创建自定义异常类

• 提供程序可能产生的所有预期错误的声明性清单；使维护更容易

• 允许您有选择地捕获特定的异常，特别是在您建立有用的异常层次结构时：

  class ValidationError(ValueError):
      pass
  
  class NameTooShortError(ValidationError):
      pass
  
  ...
  
  class DatabaseError(RuntimeError):
      pass
  
  class DatabaseWriteError(DatabaseError):
      pass
  

• 允许您更好地将表示和代码分开：您放入异常的消息不一定是最终用户将看到的消息，特别是如果您将应用程序本地化为多种语言。对于自定义类，您可以这样编写前端（使用通用的HTML模板语法，_()是gettext本地化函数）：

  {% if isinstance(e, NameTooShortError) %}
    <p>{{ _('Entered name is too short, enter at least %d characters') % e.min_length }}</p>
  {% elif isinstance(...) %}
    ...
  {% else %}
    {# fallback for unexpected exceptions #}
    <p>{{ _('An error occurred: %s') % e }}</p>
  {% endif %}
  

  试着用ValueError(f'Name too short: {name}')…