Python3终端中含零宽/双宽字符的字符串宽度计算及curses格式化问题

我太懂你这个痛点了——用curses做字符串格式化时，len()完全没法准确算出终端里的实际显示宽度，毕竟有不可见的控制字符，还有占2列的宽字符（比如全角符号、中文）。你试过用unicodedata.category过滤，但这还不够，得结合终端的字符宽度判断才行。

下面给你一套完整的解决方案：

核心思路 #

1. 过滤不可显示字符：借助curses自带的wcwidth()函数判断字符是否可显示（返回-1的就是不可显示的控制字符）。
2. 计算实际显示宽度：同样用wcwidth()获取每个可显示字符的终端列宽（1或2，少数情况可能更多），累加得到总宽度。
3. 格式化字符串：根据目标宽度，要么补空格填充，要么截断后加续行符。

代码实现 #

import curses

def get_display_metrics(s):
    """计算字符串的实际显示宽度，并返回清理掉不可显示字符后的字符串"""
    cleaned_chars = []
    total_width = 0
    for char in s:
        char_width = curses.wcwidth(char)
        # 只保留可显示且占宽度的字符（char_width > 0）
        # 如果要保留零宽格式字符，可改为char_width >= 0，且不增加total_width
        if char_width > 0:
            cleaned_chars.append(char)
            total_width += char_width
    return total_width, ''.join(cleaned_chars)

def format_curses_string(s, target_width, continuation_char='→'):
    """将字符串格式化为目标宽度：短则补空格，长则截断加续行符"""
    display_width, cleaned_str = get_display_metrics(s)
    
    if display_width <= target_width:
        # 补充空格到目标宽度
        padding = target_width - display_width
        return cleaned_str + ' ' * padding
    else:
        # 截断到目标宽度-1，预留位置给续行符
        current_width = 0
        truncated_chars = []
        for char in cleaned_str:
            char_width = curses.wcwidth(char)
            if current_width + char_width > target_width - 1:
                break
            truncated_chars.append(char)
            current_width += char_width
        # 添加续行符
        truncated_chars.append(continuation_char)
        return ''.join(truncated_chars)

关键细节说明 #

• 为什么用curses.wcwidth()？ 这个函数是终端感知的，会根据当前终端的字符编码和设置，准确返回字符的显示列宽，比单纯用unicodedata.category判断更靠谱——比如它能直接区分全角（宽）和半角（窄）字符，不用你自己去归类。
• 不可显示字符处理：wcwidth()返回-1的字符都是终端无法显示的控制字符，直接过滤即可；如果需要保留零宽格式字符（比如零宽空格、连字符），可以调整判断条件为char_width >= 0，但这类字符不占宽度，所以不要累加到total_width里。
• 续行符适配：示例里用了单宽的→，如果你的续行符是双宽字符（比如全角的…），记得把target_width - 1改成target_width - 2，避免超出宽度。

使用示例 #

在curses程序里，你可以这样调用：

def main(stdscr):
    # 初始化curses
    curses.curs_set(0)
    stdscr.clear()
    
    test_str = "Hello 世界！\x08这是带退格的字符串"  # 包含宽字符和不可显示的退格符
    formatted = format_curses_string(test_str, 10)
    stdscr.addstr(0, 0, formatted)
    
    stdscr.refresh()
    stdscr.getch()

if __name__ == "__main__":
    curses.wrapper(main)

这个示例里，原字符串的不可显示退格符会被过滤，宽字符世界！每个占2列，最终会被正确计算宽度，要么补空格要么截断加续行符。

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