版本控制与协作 / 知识点

Git 命令速查手册

手册条目

CODE
git push
git push <remote> HEAD

将当前分支的本地提交上传到远程仓库。

推送当前分支

用于把当前检出的本地分支提交上传到远程仓库。已配置上游分支时直接执行 git push;未配置时可明确指定远程并用 HEAD 代表当前分支。

基本语法

bash
git push
git push <remote> HEAD

git push 推送到当前分支的上游分支;git push origin HEAD 将当前分支推送到 origin 中的同名分支,不必手写分支名。

高频用法

推送当前分支到 origin:

bash
git push origin HEAD

预期输出:

text
Enumerating objects: <N>, done.
Counting objects: 100% (<N>/<N>), done.
To <REMOTE_URL>
   <OLD_COMMIT>..<NEW_COMMIT>  HEAD -> feature/login

最后一行表示本地当前分支已更新远程 feature/login;提交号、对象数量和远程地址会随仓库变化。若没有新提交,通常输出 Everything up-to-date。

已存在上游关系时使用更短命令:

bash
git push

预期输出:

text
Everything up-to-date

该结果表示远程上游分支已包含当前分支的全部提交。

常用参数

  • origin:远程仓库名,可用 git remote -v 确认。
  • HEAD:当前检出的提交;在普通分支上推送时会使用当前分支名。
  • --tags:额外推送所有本地标签,默认不会随普通分支推送。
  • --dry-run:只展示将执行的推送,不实际更新远程,适合变更前检查。

风险与边界

不要为解决非快进错误直接使用 --force。当远程分支已有他人提交时,强制推送可能覆盖其历史;先执行 git fetch origin 并完成合并或变基。确需重写自己独占的远程分支时,优先使用 git push --force-with-lease origin HEAD,它会在远程分支已被他人更新时拒绝覆盖。

处于 detached HEAD 状态时,HEAD 不对应本地分支名,推送目标可能不符合预期。先执行 git branch --show-current;若输出为空,应切换到目标分支后再推送。

排障清单

  • fatal: No configured push destination:没有上游关系,执行 git push -u origin HEAD。
  • rejected (non-fast-forward):远程领先,先 git pull --rebase 或手动整合远程提交。
  • Permission denied 或 HTTP 认证失败:检查远程地址、SSH 密钥、访问令牌和仓库写权限。
  • 推错远程:用 git remote -v 核对后重新指定正确的远程名。

目录与阅读设置

记录一个想法

Git 命令速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通