mb_substr在ThinkPHP模板中失效的主因是PHP未启用mbstring扩展或编码参数缺失；正确写法为{$vo.title|mb_substr=0,10,"utf-8",false}，且需确保mb_internal_encoding("UTF-8")已设置。
mb_substr 和 mb_strlen 在 ThinkPHP 中不是框架原生函数，而是 PHP mbstring 扩展提供的多字节字符串处理函数。ThinkPHP 模板引擎支持直接调用它们，但必须满足前提：PHP 已启用 mbstring 扩展，且编码参数显式传入 "utf-8"。
为什么 mb_substr 在 ThinkPHP 模板里突然失效？
常见现象是模板中写 {$vo.title|mb_substr=0,10}，结果截出乱码、空值或报错 mb_substr(): Unknown encoding "UTF-8"。
- 最常被忽略的是：PHP 未启用
mbstring扩展——运行var_dump(extension_loaded("mbstring"))必须返回bool(true)，否则所有mb_*函数不可用 -
mb_substr第四个参数（字符编码）不能省略；ThinkPHP 模板语法不支持默认参数，写成mb_substr=0,10实际等价于mb_substr($str, 0, 10, null)，而null会被当作系统默认编码（如 ISO-8859-1），导致中文截断错误 - 数据库连接、HTTP 响应头、文件保存编码若非 UTF-8，
mb_substr即使参数正确，输入源本身已是乱码，输出必然异常
mb_substr 在模板中怎么写才安全？
ThinkPHP 模板引擎对函数调用的语法限制严格，参数必须全部显式写出，且顺序不能错。
- 正确写法：
{$vo.title|mb_substr=0,10,"utf-8",false}—— 四个参数全写，编码用小写"utf-8"（不是"UTF8"或"UTF-8"大写开头，部分旧版 PHP 对大小写敏感） - 若需加省略号，不要依赖函数内置逻辑，模板层自己拼接：
{:mb_substr($vo.title,0,10,'utf-8').(mb_strlen($vo.title,'utf-8')>10?'...':'')} - 避免在模板里嵌套判断，比如
<if condition="mb_strlen(...) gt 10"></if>—— 这种写法在 ThinkPHP 5+ 中已被弃用，且mb_strlen在条件表达式中不接受编码参数，极易出错
要不要自己封装 msubstr 函数？
ThinkPHP 社区流传的 msubstr 是兼容性兜底方案，但现代项目中基本不需要。
立即学习“PHP免费学习笔记（深入）”；
- 它存在的意义是：当服务器没开
mbstring时，退化用iconv_substr或正则模拟截取——但这类环境在 2026 年已极少见，强行保留反而增加维护成本 - 如果你已在入口文件顶部写了
mb_internal_encoding("UTF-8")，且确认extension_loaded("mbstring") === true，直接用原生mb_substr更可靠、更易调试 - 若真要封装，别把编码写死为
"utf-8"，应允许传参：function msubstr($str, $start = 0, $length = 0, $charset = 'utf-8', $suffix = false)，否则换 GBK 环境就挂了
和 htmlspecialchars 混用时要注意什么？
常见错误是先截取再转义，或顺序颠倒导致实体字符被错误计算长度。
- 正确顺序永远是：先
mb_substr截取原始字符串，再htmlspecialchars转义输出 —— 因为<这类实体占多个字节，但语义上只算 1 个“字符”，mb_strlen计算的是字节数而非视觉长度 - 错误示例：
{:htmlspecialchars(mb_substr($vo.content,0,50,'utf-8'),'utf-8')}看似合理，但如果原始内容含&，截取位置可能落在&中间，造成半截实体（如&a），浏览器解析失败 - 更稳妥做法：截取前先
htmlspecialchars全量转义，再用mb_substr—— 但注意这会把&当作 5 字节处理，视觉长度远小于预期，需按实际展示效果反复测试
真正容易被忽略的点是：ThinkPHP 模板中所有 mb_* 函数调用，都隐式依赖 PHP 运行时的当前内部编码（mb_internal_encoding() 返回值）。这个值如果不显式设为 "utf-8"，哪怕你每个函数都传了 "utf-8" 参数，某些版本的 mbstring 仍会 fallback 到系统 locale 编码，导致不可复现的截断偏移。
