使用PrettyTable库创建表格时列未对齐的原因是什么

问题现象 #

调用PrettyTable库生成表格时，最终输出的表格出现列错位、边框不对齐的异常，实际运行效果如下：

核心触发原因 #

最常见的诱因是全角宽字符宽度计算偏差：

• PrettyTable原生默认按「单个字符占1个显示宽度」的逻辑计算每列需要预留的宽度，以此排布表格竖线边框。但中文、全角标点、全角特殊符号实际在等宽终端里占2个显示宽度，老版本PrettyTable没有适配这类宽字符的实际显示宽度，仅按字符数算出来的列宽小于实际需要的宽度，就会把竖线边框挤偏，出现列不对齐的问题。
• 少数场景下是输出环境字体不匹配：如果输出表格的位置用的是非等宽字体，不同字符本身显示宽度不一致，哪怕库的宽度计算逻辑正确，最终呈现出来也会错位。
• 还有一类特殊情况是网页类输出环境自动折叠连续空格：比如部分在线编辑器、旧版Jupyter Notebook会把代码输出里的多个连续空格合并成单个，原本靠空格占位对齐的表格自然就歪了。

对应修复方案 #

• 针对宽字符计算问题：先把PrettyTable升级到最新版本，初始化表格时开启宽字符适配，同时安装wcwidth库辅助计算字符实际显示宽度，参考代码：

from prettytable import PrettyTable
# 安装wcwidth后新版PrettyTable会自动调用它计算CJK字符宽度
table = PrettyTable()
# 按需设置对齐方式
table.align = "c"

如果是不方便升级的旧版本，可以手动给包含全角字符的列设置更大的预留宽度，抵消宽字符带来的宽度差。

• 针对字体问题：把输出环境的字体替换为标准等宽字体，比如Consolas、Monaco、思源等宽黑体即可。
• 针对网页空格折叠问题：不要直接输出纯文本表格，调用table.get_html_string()方法输出HTML格式的表格，就不会受空格折叠规则影响。

内容的提问来源于stack exchange，提问作者Mohamad Reza Salehi Sadaghiani