Windows环境Git别名如何正确使用参数解决运行报错？

报错根因 #

Git 中以!开头的别名属于调用Shell执行的外部命令类型，原生不支持直接通过$1这类占位符匹配传入参数。你之前配置的ss = "!git stash save $1"在Windows Git环境下解析时，整段带$1的字符串会被识别为一个不存在的Git子命令，再加双引号包裹配置时容易触发系统提前转义$开头的变量，最终触发别名扩展失败的报错。

正确配置命令 #

直接在Git Bash中执行以下命令完成全局别名配置：

git config --global alias.ss '!f() { git stash save "$@"; }; f'

配置逻辑说明 #

• 开头的!用于标识该别名是需要调用Shell执行的外部命令，而非Git内置子命令的缩写
• 定义临时Shell函数f，函数内部通过"$@"接收执行别名时传入的所有参数，自动透传给git stash save，兼容带空格的说明文本、多参数等场景
• 末尾的f表示立即执行刚定义的函数，Git会自动把执行别名时追加的所有参数传入该函数

配置注意事项 #

Windows环境下配置这类带Shell逻辑的别名时，统一用单引号包裹别名的定义内容，不要用双引号，避免Shell提前解析$开头的变量导致配置写入异常。
配置完成后执行git ss abc，会等价运行git stash save abc，不会再触发解析报错。

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