技术问询：push.default 是否仅在未定义 ref spec 时生效？

Great question! Let's get straight to the point: Yes, the push.default Git configuration only takes effect when you run git push without specifying a ref spec (reference specification).

Let me break this down with concrete examples and explanations to make it crystal clear:

What counts as a "ref spec"? #

A ref spec is any explicit instruction you give Git about which local branch to push to which remote branch. This includes:

• Full ref specs like git push origin main:dev (pushes local main to remote dev)
• Simplified ref specs like git push origin main (pushes local main to remote main — the remote branch name is inferred to match the local one)
• Even specifying just a remote without branches, like git push origin, still falls under using a ref spec (it's a shorthand that behaves differently based on other configs, but it bypasses push.default)

When does push.default kick in? #

The push.default config exists to define Git's default behavior when you run a bare git push (no remote, no branch, no ref spec at all). For example:

• If you run just git push while on the main branch
• If your branch has an upstream set (via git branch --set-upstream-to), push.default determines how that upstream relationship is used for the default push. The simple setting (Git 2.0+ default), for instance, will push your current branch to its upstream only if the upstream branch name matches the local one.
• Older settings like matching would push all local branches that have a corresponding remote branch of the same name — but this is rarely used now because it can accidentally push branches you didn't intend to.

Key takeaway #

Think of push.default as Git's "safety net" for when you don't give explicit push instructions. As soon as you specify any ref spec (even a simple one like git push origin main), Git will follow your explicit command completely and ignore the push.default configuration.

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