答案是git push -u origin branch-name为首次推送唯一安全方式，它自动创建远程分支、设置上游追踪关系，并使后续git push和git pull无需指定参数；-u仅需执行一次，验证用git branch -vv。

git push -u origin branch-name 是首次推送的唯一安全方式

本地新建分支后直接 git push 会失败，报错 fatal: The current branch xxx has no upstream branch。这不是 Git 报错，而是它在拒绝你“猜”远程分支名——它需要明确知道推到哪、叫什么、是否跟踪。

正确做法只有一条：用 git push -u origin feature/login（把 feature/login 换成你的分支名）。这个命令干三件事：
• 把本地分支内容推到远程同名分支（远程不存在就自动创建）
• 设置本地分支的 upstream 为 origin/feature/login
• 让后续 git push 和 git pull 不再需要参数

注意：-u（即 --set-upstream）只用一次。之后改完代码，直接 git push 就行，不用再写分支名或远程名。

远程分支名和本地分支名不一致时怎么推

有时团队约定远程用 main，你本地却叫 dev；或者要推一个 hotfix 到远程的 release/v2.1 分支——这时不能靠 -u 自动匹配，必须显式指定映射关系。

git push origin dev:main —— 把本地 dev 推到远程 main，但不设置上游
git push -u origin dev:release/v2.1 —— 推送并让本地 dev 跟踪远程 release/v2.1

常见错误：
• 写成 git push -u origin main（本地没切到 main，却想设上游）
• 忘记冒号，写成 git push origin dev main（Git 会当成两个目标，报错）
• 推送后没验证，导致 git pull 仍然失败（用 git branch -vv 看有没有 [origin/xxx]）

git branch -vv 是验证关联是否生效的唯一可靠命令

git status 有时显示模糊（比如只说 “Your branch is up to date”，却不告诉你跟谁对齐）；git remote show origin 太啰嗦。真正能一眼看清“本地分支是否已关联、关联到哪个远程分支”的，只有 git branch -vv。

Permanently Clear Files from Git History

帮助用户永久删除 Git 仓库历史中的文件，适用于用户提及 “git filter-repo” 等场景。

下载

输出示例：
feature/login 7a2b3c4 [origin/feature/login] feat: login UI → 已关联，且本地比远程多 1 个 commit
dev 1f8e9d0 [origin/main] fix: config load → 本地 dev 跟踪的是 origin/main，不是 origin/dev
hotfix-123 5b6c7d8 feat: critical bug fix → 没方括号，说明没 upstream，下次 git push 还会失败

如果发现没关联，别急着重推，用 git branch --set-upstream-to=origin/main dev 补上就行，不用删分支重来。

push.default = simple 是防止误推送的关键配置

如果你没设过 push.default，Git 2.0+ 默认是 simple，这是好事：它强制要求必须有 upstream 才能 git push，避免把本地分支胡乱推到远程同名分支（比如你在本地 checkout 出一个 master，但没拉最新，current 模式会直接覆盖远程 master）。

检查当前配置：git config push.default
设为安全模式：git config --global push.default simple

这个配置不影响 git push -u 的行为，但它决定了你下次敲 git push 时 Git 是帮你挡一刀，还是默默把你推错地方。

最容易被忽略的点：很多人以为“推上去就完了”，其实关联是否生效、上游是否指向正确分支、push.default 是否设对——这三个环节任意一个出错，都会让后续协作卡在 git pull 或 git push 上，而且错误信息还不直观。