Git别名是效率刚需，必须用git config --global alias.<缩写> '<原始命令>'配置，单引号包裹、避免空格转义；推荐st/co/br/unstage等高频无歧义缩写，慎用ci，禁用带动态参数的push/pull全缩写；验证用git config --get alias.st。
Git别名不是“锦上添花”，而是每天必用的效率刚需——不配，你就是在手动重复敲 3–5 次冗余字符；配错，反而会覆盖关键命令或在不同仓库行为不一致。
git config --global alias.xx 是最直接有效的配置方式
所有常用 Git 子命令都能通过 git config --global alias 快速映射，比如 git config --global alias.st status 后，git st 就等价于 git status。它写入的是用户级配置文件 ~/.gitconfig，对所有仓库生效，且优先级低于当前仓库的 .git/config（这点常被忽略）。
常见错误现象：
- 执行
git st报错unknown command: st→ 没加--global或拼写漏空格（如写成gitconfig） - 在某个项目里
git co dev正常，换个项目却报错 → 当前仓库的.git/config里没定义co，而你误以为全局配置已覆盖全部
实操建议：
- 用
git config --list | grep alias查看是否写入成功 - 别名值带空格或特殊符号时，必须用单引号包裹，例如：
git config --global alias.lg "log --graph --oneline"会失败，应写为git config --global alias.lg 'log --graph --oneline' - 避免覆盖 Git 内置命令，比如不要设
alias.status = 'checkout'—— 这不会报错，但后果不可逆
用 ! 前缀调用外部命令或组合操作
当别名需要执行非 Git 命令（如 shell 脚本、gitk、open），或想把多个命令串起来（如 add + commit），必须加 ! 开头，否则 Git 会把它当子命令解析并报错。
典型场景：
-
git config --global alias.visual '!gitk'→git visual启动图形日志 -
git config --global alias.unstage 'reset HEAD --'（无!）→ 纯 Git 命令，等效于git reset HEAD -- file -
git config --global alias.ac '!git add . && git commit'→ 注意!只需一次，且整个字符串是 shell 命令行
容易踩的坑：
- 忘了
!导致git ac -m "msg"报unknown option: -m—— 因为 Git 把-m当作传给ac别名本身的参数，而非传给commit -
!后面的命令路径未加绝对路径或未处理空格，比如!open -a 'Visual Studio Code' .在某些 shell 下会失败
别名冲突和作用域优先级必须搞清
Git 别名有三级作用域：系统级（/etc/gitconfig）、全局级（~/.gitconfig）、本地级（.git/config）。同一名字在多处定义时，**本地 > 全局 > 系统**，后加载的覆盖先加载的。
这意味着：
- 你在公司项目里执行
git config alias.co 'switch'，那这个仓库里git co就永远走switch，哪怕全局设了checkout - 用
git config --unset alias.st只能删当前作用域的配置；要删全局的，得加--global -
git config --list默认显示所有层级合并后的结果，但看不出哪条来自哪——查具体来源要用git config --show-origin --get-regexp alias
性能影响很小，但兼容性要注意：
- 老版本 Git（switch /
restore命令，所以别名设成alias.co = switch会在旧环境直接失败 - CI/CD 环境通常没配别名，脚本里别依赖
git st，该写全称就写全称
别名 vs shell alias：别混用，也别漏掉 shell 层
Git 别名（git config alias）只作用于 git 命令本身；而 shell 别名（如 alias gs='git status'）是终端层面的字符串替换，两者互不影响，但也容易冲突。
真实痛点：
- 你设了
git config alias.st status，又在~/.bashrc里写了alias st='systemctl status'→ 终端里敲st走的是 systemd，敲git st才走 Git，极易混淆 -
git config别名无法补全参数（如git co <tab>不会列出分支），而 shell alias 完全不参与 Git 补全机制
实操建议：
- Git 别名专注“Git 命令缩写”，shell alias 专注“跨工具快捷入口”，比如
alias gc='git checkout'是冗余且危险的，alias glog='git log --oneline --graph'才合理 - 修改
~/.bashrc后务必source ~/.bashrc，否则新终端才生效；SSH 登录默认不读~/.bashrc，得在~/.bash_profile里显式source它 - 别名太多会稀释记忆——
co、ci、st、br、lg这五个足够覆盖 80% 场景，其余按需临时加
真正麻烦的从来不是“怎么加”，而是“在哪加”和“加完谁生效”。尤其当团队共用 CI 脚本、或你在 WSL/macOS/Linux 多环境切换时，.gitconfig 的路径、shell 配置文件的加载顺序、Git 版本差异，都会让同一个别名在不同机器上表现不一。动手前先 git config --show-origin --get-regexp alias 看一眼实际加载源，比反复试错快得多。
