Python ruff 的规则自定义与禁用

ruff 支持行级禁用（# noqa: e501 行尾）、文件/目录级禁用（per-file-ignores），不支持真正的块级禁用；配置优先级为行内注释

怎么禁用某个 Ruff 规则（比如 E501）

直接在代码里加注释就行，不用改配置文件。Ruff 支持行级和块级禁用，比全局关规则更安全、更可维护。

• 单行禁用：# noqa: E501 放在行尾，只忽略该行的行宽警告
• 多行块禁用：# noqa: E501 放在 if 或 def 上方，配合 # noqa: E501 结束注释（但注意：Ruff 不支持 # noqa: E501 块范围，得用 # noqa: E501 每行写，或改用 # noqa 禁用所有规则）
• 真正想禁用整块？推荐用 # noqa: E501 + # noqa: E501 两行夹住，但要小心——Ruff 实际只认行尾注释，块级控制得靠 ruff.toml 的 per-file-ignores

ruff.toml 里怎么按文件/目录禁用规则

全局关规则是下策；按文件类型或路径关才合理，比如测试文件允许长字符串，或 gen/ 目录跳过所有检查。

• per-file-ignores 是唯一正解：

  [tool.ruff]
  per-file-ignores = { "tests/**" = ["E501", "ANN101"], "src/gen/**" = ["ALL"] }

• 路径通配符用 **，不是 * —— 写成 tests/*.py 不会匹配子目录，容易漏
• "ALL" 必须全大写、带引号，写成 all 或 ALL（不带引号）都会报错
• 如果同时用了 select 和 ignore，ignore 优先级更高，但 per-file-ignores 会覆盖它们

自定义新规则？Ruff 不支持，但可以模拟

Ruff 本身没有插件机制，也不能像 Flake8 那样写 Python 插件。所谓“自定义规则”，实际只有两种可行路径。

冰舟分类信息系统

冰舟分类信息系统说明:本次更新修改了部分错误，增加了自定义标签管理，这个版本后所有页面均可调用一个标签，大大的提升了效率使用前请先 运行 install.asp 文件进行安装程序！！安装时请填写好 ACCESS文件目录以及ACCESS文件名，请确保填写的信息与FTP上的完全吻合，否则会出错！！安装玩后请，务必删除 install.asp 文件！ 本2.1版本含有强大的模板编辑功能，且初始模板均为D

下载

• 用 flake8 或 pylint 补位：在 CI 里串行跑 Ruff + 其他 linter，各自负责不同维度（比如 Ruff 做快检，Flake8 跑自定义 AST 规则）
• 用 ruff rule 查看已有规则细节，再通过 select/extend-select 组合出接近你要的效果，比如把 UP（升级建议）和 ICN（导入规范）一起开，模拟“现代 Python 风格检查”
• extend-select 只能加规则，不能删；想删得用 ignore，别指望靠它“精简规则集”

为什么改了 ruff.toml 没生效？常见卡点

Ruff 查找配置的顺序很关键，改了文件却没反应，大概率是它根本没读到你改的那个。

立即学习“Python免费学习笔记（深入）”；

• Ruff 从当前工作目录向上找第一个 ruff.toml 或 pyproject.toml，不是从文件所在目录找——在子目录运行 ruff check，可能加载的是根目录配置
• 用 ruff check --config ./ruff.toml 强制指定，适合临时验证配置是否写对
• VS Code 里改了 ruff.toml 但编辑器没刷新？重启 Python 扩展或整个窗口，Ruff Server 不自动 reload 配置
• extend-select = ["E"] 这种写法不会清空默认规则，只是叠加；真想只跑 E 类，得写 select = ["E"]

Ruff 的规则体系是“白名单驱动”的，禁用比启用更常发生，但每种禁用方式的作用域和优先级差异很大——特别是 per-file-ignores 和行内 # noqa 混用时，很容易误以为某条规则被关了，其实只是被别的配置覆盖了。