mb_substr不能直接套用substr写法，因为substr按字节截取易致中文乱码，而mb_substr按字符截取需显式指定编码（如"utf-8"），且thinkphp模板中必须传全4个参数，否则因缺编码参数或未启用mbstring扩展导致乱码或报错。
mb_substr 为什么不能直接套用 substr 的写法
因为 substr 按字节截，mb_substr 按字符截——两者参数意义相同但底层逻辑完全不同。你写 substr("你好世界", 0, 2) 得到的是前 2 个字节（可能半个中文），而 mb_substr("你好世界", 0, 2, "utf-8") 才是真正取前 2 个汉字。
常见错误现象：
- 不传
encoding参数，结果乱码或截断异常（尤其在 ThinkPHP 模板里写成{$title|mb_substr=0,10}） - 误以为
mb_substr能自动识别编码，实际必须显式指定，否则 fallback 到系统默认编码（常为ISO-8859-1） - 在没启用
mbstring扩展的环境调用，直接报错Call to undefined function mb_substr()
四个参数怎么填才不踩坑
mb_substr 必须传够 3 个参数，第 4 个（encoding）强烈建议显式写出，别依赖默认值。
-
$string：原始字符串，无特殊要求 -
$start：支持正负数，正数从头计（0 开始），负数从尾倒数（-1 是最后一个字符） -
$length：可为null（PHP 8.0+）、正数（取多少字符）、负数（从末尾往前砍掉多少字符）；例如mb_substr("1234567890", 3, -4, "utf-8")→"456" -
$encoding：必须与字符串真实编码一致，常用"utf-8"（小写，部分旧 PHP 对大小写敏感），不能写成"UTF8"或空字符串
和 substr、mb_strcut 的关键区别在哪
三者定位不同，选错就容易出问题：
-
substr：纯字节操作，快但不安全，只适合 ASCII 或已知单字节场景 -
mb_substr：按字符位置切，会智能跳过 UTF-8 多字节边界，适合做「第 N 个字符起取 M 个」这类逻辑 -
mb_strcut：按字节偏移切，但保证不切断多字节字符，适合「从第 X 字节开始取 Y 字节」这种底层控制需求（比如协议解析）
举个例子：mb_substr("?野家", 0, 2, "utf-8") → "?野"（正确按字符）；mb_strcut("?野家", 0, 4, "utf-8") → "?"（UTF-8 中“?”占 4 字节，刚好切完一个字符）
ThinkPHP 模板里怎么安全用
模板引擎不支持默认参数，mb_substr=0,10 实际等价于 mb_substr($str, 0, 10, null)，而 null 编码极易导致乱码。
- 必须写全四参数：
{$vo.title|mb_substr=0,10,"utf-8",false} - 确认服务器已启用
mbstring：代码中加var_dump(extension_loaded("mbstring"))，返回true才行 - 避免在模板里嵌套判断，比如
<if condition="mb_strlen(...) gt 10"></if>—— 这种语法在 TP5+ 已废弃，且mb_strlen在条件表达式里没法传编码参数 - 加省略号要自己拼：
{:mb_substr($vo.title,0,10,'utf-8').(mb_strlen($vo.title,'utf-8')>10?'...':'')}
最易被忽略的一点：输入源本身要是 UTF-8。如果数据库连接、HTTP 响应头、文件保存编码不是 UTF-8，mb_substr 再准也没用——它只处理传进来的字符串，不负责纠错或转码。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
