使用git branch --format的%(if)与%(align)时对齐异常问题求助

问题重现 #

想要通过--format参数优化git branch的显示效果，首先实现了复刻默认格式的命令：

git branch --format "%(if)%(HEAD)%(then)%(HEAD)%(color:green)%(else) %(end) %(refname:short)"

随后尝试添加右侧对齐信息，使用%(align:50,left)进行对齐，命令如下：

git branch --format "%(align:50,left)%(if)%(HEAD)%(then)%(HEAD)%(color:green)%(else) %(end)%(refname:short)%(end)AAA"

执行后出现对齐异常，HEAD分支对应的右侧内容偏移：

git branch --format "%(align:50,left)%(if)%(HEAD)%(then)%(HEAD)%(color:green)%(else) %(end)%(refname:short)%(end)AAA"
  testbranch1                                      AAA
  testbranch2                                      AAA
* testbranch3                                  AAA

原因分析 #

问题出在%(align)的宽度计算逻辑：它会将%(if)块内的所有格式指令字符（包括未实际输出的条件分支模板语法）纳入长度统计，而非仅计算最终渲染的可见文本长度。比如HEAD分支的%(if)块包含更多格式指令字符，导致实际内容的可用宽度被压缩，最终对齐偏移。

解决方案 #

将%(if)的条件判断逻辑直接用于生成分支前缀（* 或 ），并将前缀与分支名拼接成一个整体后再传入%(align)处理，确保%(align)仅统计实际输出的文本长度。

修正后的命令：

git branch --format "%(align:50,left)%(if)%(HEAD)%(then)%(color:green)* %(refname:short)%(else)  %(refname:short)%(end)%(end)AAA"

说明 #

• %(if)%(HEAD)%(then)%(color:green)* %(refname:short)：HEAD分支输出绿色的* 加上分支名
• %(else) %(refname:short)：非HEAD分支输出两个空格加上分支名
• 整个前缀+分支名的组合被%(align:50,left)包裹，确保左侧内容占满50个字符宽度后，右侧的AAA能对齐显示

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