Go语言如何正确计算中文字符串宽度以实现文本边框正常展示

问题根因

• len()返回的是UTF-8编码的字节数，单个中文字符占3字节，所以结果和实际显示宽度完全无关。
• 原生runewidth.StringWidth默认未开启东亚全角字符适配，对中日韩字符、全角特殊符号的宽度计算会出现1-2位的偏差。

修复方案

1. 开启go-runewidth的东亚宽度适配
   在代码初始化阶段添加如下配置，即可让全角字符按2个显示宽度计算，半角按1个计算，覆盖绝大多数常规场景：

runewidth.DefaultCondition.EastAsianWidth = true

2. 复杂字符场景使用更精准的宽度计算库
   如果字符串包含emoji、特殊Unicode符号，推荐使用uniseg库的StringWidth方法计算，对复杂字符的宽度判定准确率更高。
3. 终端环境校验
   确认你使用的终端采用等宽字体渲染，且字体对全角中日韩字符支持正常，否则就算宽度计算正确，也会出现显示错位的问题。

可对齐的示例代码

package main

import (
	"fmt"
	"github.com/mattn/go-runewidth"
)

func main() {
	// 开启东亚全角宽度适配
	runewidth.DefaultCondition.EastAsianWidth = true
	
	cnStr := "这是一个测试"
	enStr := "aaaaaaaaaa"
	
	fmt.Printf("%s | 中文\n", cnStr)
	fmt.Printf("%s | 10个半角a\n", enStr)
}

运行后输出的两条竖线会完全对齐，你可以用计算得到的准确宽度来动态计算边框的长度，实现边框正常展示的需求。

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