ThinkPHP中截断中文文本最稳妥方式是显式使用mb_substr并指定UTF-8编码，需确保启用mbstring扩展，模板中必须传全参数，建议封装truncate函数并配合前后端校验。
ThinkPHP 中用 mb_substr 截断超长文本最稳妥
直接用 PHP 原生 mb_substr 是 ThinkPHP 里处理中文超长文本截断的首选，框架本身不提供专门的“安全截断”函数，substr 在中文场景下极易乱码或截断半个 UTF-8 字节，必须规避。
实操建议：
- 确保项目已启用
mbstring扩展（可通过phpinfo()或extension_loaded('mbstring')检查） - 统一指定编码为
'UTF-8'，哪怕配置了默认编码，显式传参更可靠 - 截断后手动补省略号时，先判断是否真被截断，避免末尾多出 “…”
// 示例：在控制器或模板中使用
$content = '这是一段很长的中文内容……';
$short = mb_substr($content, 0, 50, 'UTF-8');
if (mb_strlen($content, 'UTF-8') > 50) {
$short .= '…';
}
模板中用 {:mb_substr($text,0,30,'UTF-8')}... 要小心编码丢失
ThinkPHP 模板引擎不自动传递编码参数，直接写 {:mb_substr($text,0,30)} 会走默认编码（可能是 ISO-8859-1），中文立刻出问题。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 截出来一堆 符号
- 长度计算不准（比如显示 20 个字，实际只取了 10 个汉字）
- 末尾省略号和截断内容粘连或错位
正确做法是显式写全参数，且推荐封装成模板函数：
// 在 common.php 或模板函数文件中注册
function truncate($str, $len = 30, $suffix = '…') {
if (mb_strlen($str, 'UTF-8') <= $len) return $str;
return mb_substr($str, 0, $len, 'UTF-8') . $suffix;
}
// 模板中调用
{:truncate($article['desc'], 40)}
Str::limit() 在 ThinkPHP 6+ 可用但有陷阱
ThinkPHP 6 引入了 think\helper\Str 类，其中 limit() 方法看起来很省事，但它底层用的是 substr + strlen，对中文完全不友好——除非你提前把字符串转成单字节编码（不现实）。
所以：
- 不要对含中文的字段直接用
Str::limit($text, 50) - 如果非要调用，必须先确认该字段只含 ASCII 字符（如英文 slug、token）
- 查看源码会发现它没做
mb_*判断，也无编码参数入口
等效于白包装了一层 substr，中文场景下等于自埋雷。
数据库字段类型与前端限制要协同处理
后端截断只是最后一道防线。如果数据库字段是 VARCHAR(255)，而业务要求展示 200 字中文，那插入时就该校验长度，而不是等查出来再截。
建议组合策略：
- 入库前用
mb_strlen($input, 'UTF-8') > 200拒绝过长内容，返回明确提示 - 前端 textarea 加
maxlength属性（注意：HTML 的maxlength对中文也按字符计，可用） - API 返回时再用
mb_substr做兜底，防数据异常或绕过前端校验
单独依赖任何一环都容易漏掉边界情况，比如用户禁用 JS 后绕过前端限制，或历史脏数据已存在库中。
