Git别名定义被截断报错，如何正确配置untrack别名？

问题原因 #

执行git config --system alias.untrack 'rm --cached'时，shell对单引号的解析导致参数被截断：rm --cached中的空格被识别为参数分隔符，使得Git仅接收到rm作为别名的值，最终配置被截断为alias.untrack='rm，触发未闭合引号的错误。

解决办法 #

方法1：用双引号包裹别名内容 #

执行以下命令，双引号能让shell将rm --cached作为完整参数传递给Git：

git config --system alias.untrack "rm --cached"

方法2：直接编辑系统配置文件 #

找到Git系统配置文件（通常路径为/etc/gitconfig），手动添加以下内容：

[alias]
    untrack = rm --cached

这种方式完全规避shell解析问题，配置更可靠。

验证配置 #

执行以下命令检查别名是否配置正确：

git config --system --get alias.untrack

若输出rm --cached，说明配置成功，此时执行git untrack <目标文件名>即可正常移除文件的追踪状态。

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