关于git branch --create可执行但无文档记录的技术疑问

• 这个现象的核心原因是Git的长选项前缀匹配机制：Git允许输入长选项的前缀，只要该前缀能唯一匹配到一个官方定义的完整长选项，就会被识别为对应选项。
• 你输入的git branch --create branchname中，--create其实是官方选项--create-reflog的缩写（没有其他长选项以--create开头，因此匹配唯一）。该选项的作用是为新创建的分支强制生成reflog（引用日志），而创建分支的实际操作是由后面的位置参数branchname触发的（和git branch branchname的分支创建逻辑一致）。
• 官方文档和AI工具未提及--create的原因：它不是独立的官方选项，只是--create-reflog的前缀简写，Git官方仅在文档中列出完整长选项，不会主动说明所有合法的前缀匹配情况。
• 验证方法：执行git branch --create-reflog test和git branch --create test，效果完全一致；若输入不唯一的前缀（比如git branch --c），Git会报错，提示存在多个匹配选项（如--copy和--create-reflog）。
• 补充说明：多数环境下Git默认开启core.logAllRefUpdates配置，本地分支会自动生成reflog，因此使用--create和直接创建分支的表现无差异，容易让人误以为--create是创建分支的选项。

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