<p>Ruff 支持行级禁用（# noqa: E501 行尾）、文件/目录级禁用（per-file-ignores），不支持真正的块级禁用；配置优先级为行内注释 < per-file-ignores < 全局 ignore；修改 ruff.toml 需确保被正确加载。</p>
怎么禁用某个 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 插件。所谓“自定义规则”，实际只有两种可行路径。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 用
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 混用时，很容易误以为某条规则被关了，其实只是被别的配置覆盖了。
