跳到内容

invalid-formatter-suppression-comment (RUF028)

修复总是可用的。

作用

检查对格式化程序的抑制注释,这些注释无效或与 Ruff 的格式化程序不兼容。

为什么这不好?

实际上并没有阻止格式化的抑制注释可能会在运行格式化程序时导致意外更改。

示例

在以下示例中,所有抑制注释都会导致规则冲突。

def decorator():
    pass


@decorator
# fmt: off
def example():
    if True:
        # fmt: skip
        expression = [
            # fmt: off
            1,
            2,
        ]
        # yapf: disable
    # fmt: on
    # yapf: enable

修复安全性

此修复始终标记为不安全,因为它删除了无效的抑制注释,而不是尝试将其移动到有效位置,而用户更可能打算这样做。