如何绕过Ruff检查提交代码至分支？

先搞定Git无提交内容的问题 #

• 先执行git status查看文件状态，确认要提交的文件是否处于已暂存状态（显示Changes to be committed）
• 如果文件是未追踪状态（显示Untracked files），先执行git add <文件名>或者git add .把文件加入暂存区，再重新执行提交命令

忽略Ruff错误完成提交的几种方法 #

方法1：临时跳过预提交钩子（适用于用pre-commit触发Ruff的场景） #

如果你的项目是靠pre-commit框架来跑Ruff检查的，提交时直接加--no-verify参数就能跳过所有预提交检查：

git commit -m "test" --no-verify

提交完成后直接执行git push即可推送到分支

方法2：临时修改Ruff配置忽略特定错误 #

不想完全跳过检查的话，可以临时修改项目根目录的ruff.toml（或pyproject.toml中的Ruff配置）：

• 找到ignore配置项，把当前导入错误对应的规则码加进去，比如未使用的导入对应F401、导入位置不符合要求对应E402：

  # ruff.toml示例配置
  ignore = ["F401", "E402"]
  

• 保存配置后，执行git add .把配置文件也加入暂存区，再正常执行提交命令即可

方法3：临时禁用Ruff的预提交钩子 #

要是只是临时不想让Ruff触发检查，找到项目中的.pre-commit-config.yaml文件，把Ruff相关的钩子注释掉：

# - repo: https://github.com/astral-sh/ruff-pre-commit
#   rev: v0.1.14
#   hooks:
#     - id: ruff
#       args: ["--fix"]

注释完成后可以执行pre-commit autoupdate确保配置生效，之后就能正常提交了，记得后续要恢复原配置

内容的提问来源于stack exchange，提问作者Francis McCann