Java打印Unicode扑克牌时字符占位不匹配导致排版错乱

问题根因 #

这套排版错位的核心原因非常明确：

• 现有卡牌边框的硬编码长度，是默认每个字符占1个半角终端宽度计算的
• getFace()返回的扑克牌花色符号（比如♠♥♦♣），在绝大多数等宽终端里是全角显示宽度，实际占2个半角字符位，和预设的1个宽度不匹配
• 写第4行带花色的内容时，硬编码了“5个横线+1个花色+5个横线”的结构，按1个宽度算总中间宽度是11个，实际因为花色占2个，最终中间宽度只有10个，比上下边框的中间宽度少了1个位置，直接导致这行的右边框比其他行靠左1个字符，单卡边框歪斜，多卡拼接的时候错位会被进一步放大。

可直接落地的修复步骤 #

1. 先写通用的终端显示宽度计算工具 #

别靠硬编码的字符数算长度，专门做一个方法计算字符串在等宽终端里的实际占位宽度，别用Java自带的String.length()——这个方法统计的是Unicode代码点数量，和实际显示宽度完全是两回事。
可以直接用下面的工具方法覆盖扑克牌场景的所有字符：

/**
 * 计算字符串在等宽终端的实际显示宽度
 */
private static int getDisplayWidth(String str) {
    int totalWidth = 0;
    for (char c : str.toCharArray()) {
        // ASCII范围内的半角字符、边框制表符、空格、数字字母都算1个宽度位
        if (c < 0x100) {
            totalWidth += 1;
        } else {
            // 非ASCII的全角字符、扑克牌花色这类符号统一按2个宽度位计算
            totalWidth += 2;
        }
    }
    return totalWidth;
}

2. 把硬编码横线的逻辑改成动态补全，固定单卡总宽度 #

现有定义的单卡上下边框是固定13个半角宽度位（左右两个│边框，中间11个横线长度），只要保证每一行的总宽度严格等于这个值，边框就不会歪。
原来的花色行硬编码内容换成动态计算：

// 固定单卡内容区宽度：去掉左右两个│边框，中间可用宽度为11个半角位
int cardContentWidth = 11;
String faceSymbol = getFace();
int faceWidth = getDisplayWidth(faceSymbol);
// 剩下需要用横线填充的总宽度
int remainDashTotal = cardContentWidth - faceWidth;
// 横线尽量左右均分，保证花色在中间
int leftDashCount = remainDashTotal / 2;
int rightDashCount = remainDashTotal - leftDashCount;
// 生成新的花色行
card[4] = "│" + "─".repeat(leftDashCount) + faceSymbol + "─".repeat(rightDashCount) + "│";

按常规扑克牌花色的宽度计算，♠的宽度是2，那剩余可分配的横线宽度是9个，左侧放4个，右侧放5个，总中间宽度就是4+2+5=11，和上下边框的中间宽度完全一致，右│的位置就和其他行对齐了。

3. 所有硬编码补空格的位置统一换成动态补位 #

现有代码里写左上角、右下角的牌值时，是靠数空格数补位的，遇到宽度不是1的牌值（比如10、全角特殊符号）很容易错，统一用同样的逻辑补位就行：
比如左上角牌值行，原来的硬编码空格部分可以改成：

String topCornerValue = getNumber() < 10 ? " " + getNumber() : 
    getNumber() ==10 ? "10" : getNumber() ==11 ? " J" : getNumber() ==12 ? " Q" : " K";
int cornerValueWidth = getDisplayWidth(topCornerValue);
int padSpaceCount = cardContentWidth - cornerValueWidth;
card[1] = "│" + topCornerValue + " ".repeat(padSpaceCount) + "│";

右下角的牌值行也用一样的逻辑，靠右对齐补空格就行，不用硬写固定数量的空格。

4. 多卡渲染的逻辑不用改 #

只要保证单张卡牌每一行的实际显示宽度完全一致，renderCard()里逐行拼接、卡之间加3个半角空格的逻辑就不会出问题，不会出现行长短不一的错位。

注意事项 #

• 不要依赖字符串的length()方法判断占位长度，半角/全角混排的时候这个值完全不准
• 所有补位用的空格统一用半角空格，不要混进全角空格，否则又会出现宽度计算错误
• 如果用的是Java 11以下版本，没有内置String.repeat()方法，可以自己写循环拼接固定字符的工具方法实现同样效果，不影响整体排版逻辑
• 如果后续要加其他特殊Unicode符号，只需要在宽度计算方法里调整对应字符的宽度值就行，不用改整体排版逻辑

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