为何`git log --pretty`需加等号？两类命令执行差异解惑

核心问题：参数传递逻辑的差异 #

执行git log --pretty "format:%h %s"时报错，本质是Git对--pretty选项的参数解析规则导致的：

• --pretty支持两种参数形式：预定义格式名（如oneline、short）和自定义格式（format:...）。
• 当用空格分隔传递参数时，Git只会将参数视为预定义格式名。而"format:%h %s"并不是Git内置的格式名，Git会误把它当作要查询的Git对象（commit、分支、标签等），但这个字符串不是有效的对象名，因此抛出fatal: invalid object name 'format'.错误。

另外两种写法成功的原因 #

1. git log --pretty="format:%h %s"：
   用等号连接选项和参数时，Git会将等号后的整个字符串format:%h %s完整识别为--pretty的自定义格式参数，正确解析并输出指定格式的日志。

2. git log --author bob：
   --author选项的参数是普通字符串（作者名），不需要特殊前缀，Git能直接识别空格后的bob是该选项的过滤参数，而非对象名，因此可以正常筛选出作者为bob的提交日志。

总结 #

Git中需要传递复杂格式参数的选项（如--pretty的自定义格式），必须使用--option=value的等号连接形式；而参数为简单字符串的选项（如--author），用空格分隔传递参数是有效的。

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