git commit --no-verify 可跳过 pre-commit 钩子，仅对当前提交生效，不影響 pre-push 或 commit-msg；若失效，可能是 husky 封装、别名冲突、终端环境或参数未透传所致。
git commit 怎么跳过 pre-commit 钩子
直接加 --no-verify 参数就能绕过本地 pre-commit 钩子，比如：git commit -m "xxx" --no-verify。这不是“禁用钩子”，而是告诉 Git 本次提交不触发验证逻辑。
常见错误现象：改完代码想快速提交，结果卡在 ESLint 报错或测试没过，但你确定这次提交只是临时调试——这时硬等检查通过反而拖慢节奏。
- 只对当前提交生效，不影响后续操作
- 不会跳过
pre-push或commit-msg钩子，那些得另加参数（如--no-verify对pre-push无效） - 某些公司级 husky 配置可能拦截该参数，需确认
.husky/pre-commit脚本里没做白名单过滤
为什么 --no-verify 有时不起作用
根本原因不是 Git 忘了这个参数，而是钩子本身被封装在了更高层工具里。比如用 npm run commit 或 pnpm exec git commit 包了一层，命令参数没透传过去。
使用场景：你在 VS Code 终端里敲 git commit -m "test" --no-verify 没反应，但换到系统终端就正常——大概率是编辑器集成终端的 shell 配置或 alias 干扰了参数解析。
- 检查是否用了别名：
git config --get alias.commit，如果返回类似!git commit --no-verify这种，那再加--no-verify就重复了，甚至可能被误解析 - 某些 husky v7+ 版本默认启用
HUSKY=0环境变量来禁用全部钩子，比--no-verify更彻底，但影响范围更大 - Windows 下 CMD 和 PowerShell 对双短横线参数处理略有差异，优先用 Git Bash 或 WSL 测试
跳过 commit-msg 钩子要单独处理
--no-verify 只管 pre-commit，不管提交信息校验。如果你用的是 conventional commits 规范，commit-msg 钩子会单独校验 message 格式，报错像：subject may not be empty [subject-empty]。
这时候必须显式跳过它：git commit -m "chore: skip msg check" --no-verify 不行，得用：git commit -m "chore: skip msg check" -n（-n 是 --no-verify 的简写，但部分旧版 husky 要求配合环境变量）。
- 更可靠的做法是临时关掉：
HUSKY=0 git commit -m "xxx" - 注意
commit-msg钩子路径通常是.git/hooks/commit-msg，可手动 chmod -x 临时禁用，但记得恢复 - VS Code 的 Git GUI 提交界面通常不支持传参，这类操作必须走命令行
团队协作中跳过钩子的风险点
能跳过，不等于该跳过。最常被忽略的是：CI 流水线仍然会跑完整检查，本地跳过只是把失败从「提交前」挪到了「推送后」，反而更难定位问题。
比如你用 --no-verify 提交了一个带 console.log 的调试代码，本地过了，但 push 到 GitHub 后 CI 因 ESLint 失败直接拒收——这时你得重写 commit，还可能污染分支历史。
- 建议只在明确知道后果时跳过，例如：修复钩子自身 bug、紧急 patch 且已人工确认无风险
- 不要把它当成日常开发习惯，尤其当项目有
lint-staged+prettier组合时，格式问题几乎必然引发冲突 - 如果频繁需要跳过，说明钩子配置太重或规则不合理，该优化的是钩子，不是绕过方式
