PHP mb_strwidth 怎样计算终端显示宽度

PHP 在终端输出中文表格时，最容易踩的坑不是字符串不能读取，而是“字符个数”和“屏幕占几列”并不是一回事。strlen()统计的是字节数，mb_strlen()更接近字符数，而 mb_strwidth()才是按终端显示宽度判断的入口：半角字符通常记为 1，全角字符通常记为 2。

PHP 官方手册：https://www.php.net/manual/en/function.mb-strwidth.php

一、先区分字节数、字符数和显示宽度

例如“订单-北京”包含中文、连字符和英文字母。中文在常见等宽终端里占两列，ASCII 字符占一列；因此用字符数补齐，遇到中日韩文本仍可能错位。mb_strwidth()按 East Asian Width 规则提供了更合适的估算，返回值是整数宽度，而不是字节数。

二、用编码参数计算中日韩文本的终端宽度

mbstring不是 PHP 默认启用的扩展。部署后先确认扩展存在，再让 UTF-8 成为调用约定。省略第二个参数或传入 null 会使用内部字符编码；在公共格式化函数里显式写出 UTF-8，更容易测试和排查。

这里的 columns才应该拿去和表头、分隔线的列宽比较。它仍然是通用估算：终端字体、组合字符和某些 Emoji 的渲染差异，不能靠一个 PHP 整数完全覆盖。

三、把宽度计算和截断组合起来

如果字段超过 18 列，先判断再截断；不要先用 substr() 切字节，这可能切断 UTF-8 字符。mb_strimwidth()按宽度截取，最后一个参数可以指定省略标记。

若业务要求中文省略号“…”而不是三个点，要重新计算标记宽度，并用同一个 encoding 传给两个函数。表格补齐时还要注意：填充字符串也应按实际列宽设计，不能把重复次数当作视觉宽度。

四、全角符号、边界值和对齐策略

最小回归样例至少包括空字符串、纯 ASCII、纯中文、混合文本、全角标点和刚好等宽的字符串。对每条样例记录“输入、显示宽度、截断结果”，这样改动终端表格时能快速发现列线漂移。

还要把目标环境写清楚：同一串文本在不同终端、字体或组合字符规则下，实际视觉效果可能有差异。mb_strwidth()解决的是 PHP 侧的宽度度量，不是终端渲染器的完整模拟。对日志机器可读性要求更高时，可以同时输出原始字段和已经格式化的展示字段。

五、用检查清单落地到日志和表格输出

• 输入统一为 UTF-8，格式化函数不依赖隐含的内部编码。
• 列宽计算只使用 mb_strwidth()，字符数量限制才使用 mb_strlen()。
• 截断只使用 mb_strimwidth()，并预留省略标记宽度。
• 部署检查包含 mbstring 扩展，回归样例包含中日韩和全角符号。

这样做的核心是先选对单位，再谈补空格。只要列宽、截断和填充都围绕同一个“显示宽度”单位，PHP 终端表格就不会因为中文字符变多而突然失去对齐。

相关问题

mb_strwidth() 能统计 UTF-8 字节长度吗？

不能。它返回显示宽度；要统计字节长度使用 strlen()，要统计字符数使用 mb_strlen()。

为什么 mb_strwidth() 的结果和浏览器宽度不一样？

该函数面向字符宽度规则和等宽场景，浏览器还会受字体、字号、CSS 和排版引擎影响，不能直接互换。

只想限制数据库字段长度应该用哪个函数？

那是存储或字节边界问题，应根据字段定义选择字节截断或字符截断；不要把终端显示宽度当成数据库容量。