pre-commit钩子拦截是git提交失败最常见原因，本质是eslint等本地检查未通过，导致commit对象未生成；需先定位拦截层（环境/配置/权限等），再针对性修复。

Git提交失败不是代码丢了，而是流程卡在某个环节——先定位是哪一层拦住了，再针对性解决。

提交被 pre-commit 钩子拦截（比如 ESLint、Prettier）

这是最常见的“失败”：命令行显示 husky - pre-commit script failed 或 eslint --fix [FAILED]，但 Git 本身没报错。本质是代码没通过本地检查，Git 连 commit 对象都没生成。

• 运行 git status 确认文件确实已 git add，且状态是 “to be committed”
• 直接手动执行钩子里的命令，例如：npx eslint --fix src/App.vue，看具体哪行报错
• 临时跳过检查（仅调试用）：git commit --no-verify -m "temp"，但别推到远程
• 如果只是个别文件不合规，先 git reset HEAD <file></file> 暂不提交，修好再加

提示 “Please tell me who you are”

Git 拒绝创建 commit，因为缺少作者身份。这不是网络或权限问题，而是本地配置缺失。

Pilot Digital Twin Setup

部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……

下载

• 检查是否设置了用户信息：git config --global user.name 和 git config --global user.email
• 若为空，立即补上：git config --global user.name "Your Name"，git config --global user.email "you@example.com"
• 注意：邮箱必须和你 Git 平台（GitHub/GitLab/GitCode）注册账号一致，否则后续 push 可能被拒
• 如果只针对当前项目设，去掉 --global，并在项目根目录下执行

执行 git commit 后提示 “nothing to commit, working tree clean”

你改了文件，Git 却说“没东西可提”——大概率是文件被忽略、未保存，或换行符/权限变更没触发跟踪。

• 用 git check-ignore -v path/to/file 查看是否命中 .gitignore 规则
• 编辑器可能没真正保存（尤其 VS Code 有时缓存未写盘），强制保存并重试
• 跨平台开发时，git config core.autocrlf 设置错误会导致文件“看似修改实则无 diff”，Windows 推荐设为 true，macOS/Linux 设为 input
• 用 git status -u 查看未跟踪文件，确认修改是否出现在列表里

已经 commit 但 push 失败：rejected - non-fast-forward

远程分支有你本地没有的新提交（比如别人刚 push 了），Git 拒绝直接覆盖，这是保护机制，不是错误。

• 最安全做法：git pull --rebase origin main，把你的提交“叠”在别人更新之后
• 如果 pull 后出现冲突，解决后 git add <file></file>，再 git rebase --continue
• 绝对避免无沟通的 git push -f；如确需强制推送，用 git push --force-with-lease，它会检查远程是否有你不知道的新提交
• IDEA 用户可在 Pull 对话框中勾选 “Rebase current branch on upstream branch”，比命令行更直观

所有提交失败场景里，最容易被忽略的是：你以为失败了，其实 commit 已成功生成，只是没 push 出去。用 git log --oneline -n 5 看最新几条记录，确认你的提交是否已在本地历史中——这决定了该用 reset、revert 还是直接 push。