git config --global alias.xxx 必须带 --global 和单引号包裹值；多命令/参数需用 !+函数；缩写应高频无歧义且支持任意参数；验证用 git config --get 和 git cmd --help。
别名不是“锦上添花”，而是每天多敲几十次空格、斜杠、双引号后，手指发酸才意识到的刚需。 配对正确、边界清晰的 alias 能省下真实时间，配错或滥用反而增加认知负担和执行失败率——关键在怎么写、写什么、为什么不能乱写。
git config --global alias.xxxx 这条命令必须带什么
必须用 git config --global alias.xxx，不能漏掉 --global（否则只在当前仓库生效），也不能把 alias 写成 aliases 或拼错。值部分必须用单引号包裹，比如 'status'，双引号在某些 shell 下会让 $1 提前展开，导致参数失效。
-
git config --global alias.st status✅ 正确，git st等价于git status -
git config --global alias.st "status"⚠️ macOS zsh 下可能正常，但 Windows cmd 会报错 -
git config alias.st status❌ 没加--global，只对当前目录下的 Git 仓库有效 -
git config --global alias.status status❌ 覆盖内置命令，git status就再也用不了了
什么时候必须加 ! 和函数包装
只要别名要执行多个命令、带参数、或需要条件判断，就必须用 ! 开头 + 单引号 + shell 函数结构。Git 本身不解析 && 或 ;，没 ! 就只执行第一个词。
-
git config --global alias.ac '!git add -A && git commit -m "${1:-auto}"'✅ 参数${1:-auto}可传入，git ac "init"会提交带 message 的 commit -
git config --global alias.ac 'add -A && commit -m "auto"'❌ Git 会尝试找名为add的子命令，报unknown command -
git config --global alias.lg "log --graph --oneline"✅ 单命令带参数，不用!；但注意：如果终端不支持 ANSI 颜色，--color=always会白屏
哪些缩写真省事，哪些是自找麻烦
高频、无歧义、参数灵活的命令才值得缩。缩完还得能接任意参数，否则不如不缩。
-
st→status：✅ 安全，git st -s、git st -b全都通 -
co→checkout：✅git co main、git co -b feat都行 -
ci→commit -m：⚠️ 表面省事，但git ci -a或git ci --amend会失败，得切回全称 -
ps→push origin main：❌ 固定远程和分支，换项目就得改别名，不如用git ps+ 手动输origin dev -
unstage→reset HEAD --：✅ 推荐，git unstage file.txt比记reset参数直观得多
验证和调试 alias 的实际方法
别名是否生效，不能只靠“看起来像”，得用 Git 自己的机制验证：
- 查配置：
git config --get alias.st应输出status；若为空，说明没配对或拼错了 key - 看展开：
git st --help实际运行的是git status --help，说明 alias 被正确代理 - 试参数：
git co -b new-branch如果报unknown option: -b，说明你配的是checkout -b这种固定参数形式，而不是纯checkout - Windows 用户特别注意：
!别名里避免用双引号，cmd 解析异常；统一用单引号，且确保路径中没中文空格
最常被忽略的一点：别名里的 git -C /path 会改变当前工作区上下文，导致后续命令（比如 git status）显示的是那个目录的状态，而不是你敲命令时所在的目录——这种副作用很难 debug，除非你明确需要跨目录操作，否则别往 alias 里塞 -C。
