Git别名需用git config --global alias.<name> <command>设置，加!为shell函数支持参数处理，不加则为简单命令替换；生效后可用git config --get-regexp alias\.验证。
git config --global alias. 后面跟什么才真正生效
别名不是写完就自动可用的，git config --global alias.co checkout 这类命令必须确保 alias 后紧跟一个合法的 Git 子命令或自定义 shell 命令。Git 会把 co 当作 checkout 的缩写，但如果你写成 git config --global alias.ci "commit -m"，执行 git ci "hello" 时会报错：error: unknown switch `m' ——因为 Git 默认把引号里的内容整体传给 commit，而 -m 被当成了 commit 的参数，不是你预设的固定选项。
- 正确做法是用引号包裹整个命令，并显式写出参数占位符：
git config --global alias.ci '!f() { git commit -m "$1"; }; f' - 单字母别名（如
co、st）优先用内置命令映射，避免覆盖已有子命令（比如别把alias.st设成status -s，但 Git 本身就有st别名，冲突时以后设为准） - Windows 用户注意：PowerShell 对
!和$1解析不一致，建议在 Git Bash 下设置；若必须用 PowerShell，改用git config --global alias.ci "commit -m"+ 手动补全引号，但丧失参数透传能力
alias 里用 ! 开头和不用 ! 的根本区别
加 ! 表示这是 shell 函数，不加就是简单命令替换。前者能做逻辑判断、参数处理、多步操作；后者只是字符串拼接后交给 Git 执行。
- 不加
!：git config --global alias.unstage 'reset HEAD --'→ 执行git unstage file.txt等价于git reset HEAD -- file.txt，参数直接追加 - 加
!：git config --global alias.lg '!f() { git log --oneline --graph --all --decorate "$@"; }; f'→"$@"保证所有传入参数原样透传，支持git lg -n 5或git lg main..dev - 漏写结尾的
; f是常见错误，会导致函数定义不执行，调用时提示fatal: cannot run ...: No such file or directory
如何查 alias 是否生效、有没有冲突
别名写完别急着用，先验证。Git 不报错不代表它按你想的跑。
- 列出所有 alias：
git config --get-regexp alias\.（注意末尾点号要转义） - 看某个别名展开结果：
git config --get alias.co→ 返回checkout，说明是静态映射；返回!f() { ... }; f就是函数型 - 测试是否被覆盖：
git co --help应该显示checkout的帮助，如果显示unknown command，说明 alias 没注册成功或拼写错误 - Windows 上若 alias 含空格或特殊字符，
git config可能静默失败，建议用--edit直接打开配置文件手动核对[alias]区块
alias 太多怎么维护不混乱
别名一多，.gitconfig 里全是 alias.xxx = ...，改起来费劲，协作时也难同步。
- 把 alias 单独拆到外部文件：
git config --global include.path ~/.gitconfig-aliases，然后在~/.gitconfig-aliases里写[alias]区块 - 团队共享时，别硬塞进全局配置，改用
git config --file .git/config alias.pr '!f() { git fetch origin pull/$1/head:pr-$1 && git checkout pr-$1; }; f'放进项目级配置，避免污染个人环境 - 别名命名避免歧义：比如
git sync到底是pull + push还是rebase + push？不如明确叫git sync-upstream或git sync-origin
alias 最容易被忽略的其实是执行上下文——它总在 Git 工作目录里运行，没法跨仓库自动切换；想批量操作多个 repo，得另写脚本，别指望 alias 自己搞定。
