PyQt5 QListWidget文本宽度对齐异常问题求助

问题根源 #

控制台使用的是等宽字体，每个字符宽度一致，所以f-string的宽度控制能精准对齐；但QListWidget默认采用比例字体（像i和w这类字符宽度差异明显），导致格式化后的字符串在界面上无法对齐，只有空白占位时因为都是宽度一致的空格，才会显示正常。

可行解决方案 #

1. 给QListWidget设置等宽字体 #

这是最简单的解决方式，将QListWidget的字体替换为等宽字体（比如Consolas、Monaco、宋体），让每个字符宽度统一，f-string的宽度控制就能生效：

from PyQt5.QtGui import QFont

# 假设你的QListWidget实例名为list_widget
fixed_font = QFont("Consolas")
list_widget.setFont(fixed_font)

2. 改用QTableWidget实现列对齐 #

如果是结构化的多列数据，直接使用QTableWidget更合适，它原生支持列对齐和宽度管理，无需依赖字符串格式化：

from PyQt5.QtWidgets import QTableWidget, QTableWidgetItem
from PyQt5.QtCore import Qt

# 初始化表格
table = QTableWidget()
table.setColumnCount(2)
table.setHorizontalHeaderLabels(["名称", "价格"])

# 添加数据行
data = [("Burger", 10.99), ("Fries", 5.99), ("Cola", 3.99)]
for row_idx, (name, price) in enumerate(data):
    table.insertRow(row_idx)
    # 名称列左对齐
    name_item = QTableWidgetItem(name)
    name_item.setTextAlignment(Qt.AlignLeft)
    table.setItem(row_idx, 0, name_item)
    # 价格列右对齐
    price_item = QTableWidgetItem(f"{price:.2f}")
    price_item.setTextAlignment(Qt.AlignRight)
    table.setItem(row_idx, 1, price_item)

# 自动适配列宽
table.resizeColumnsToContents()

3. 手动计算字符补空格（不推荐） #

如果一定要用QListWidget，可以通过QFontMetrics计算每个字符串的实际显示宽度，手动补充空格，但这种方法繁琐，更换字体后还需重新计算：

from PyQt5.QtGui import QFontMetrics

metrics = QFontMetrics(list_widget.font())
# 先算出所有名称里最宽的那个的显示宽度
max_name_width = max(metrics.width(name) for name, _ in data)

for name, price in data:
    # 计算需要补充的空格数量
    space_needed = (max_name_width - metrics.width(name)) // metrics.width(" ")
    line_text = f"{name}{' ' * space_needed} | {price:.2f}"
    list_widget.addItem(line_text)

总结 #

优先选择方法1或方法2：方法1改动最小，适合快速解决问题；方法2更专业，适合需要规范展示多列数据的场景。

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