应先确认mbstring扩展是否实际存在并加载，再检查CLI与Web环境配置差异、正确设置内部编码、避免过时功能及版本兼容问题。
php.ini 里找不到 extension=mbstring 怎么办
多数情况下不是“没开启”，而是根本没加载这个扩展——PHP 编译时没带，或者发行版默认禁用。先确认扩展文件是否存在：php -m | grep mbstring，如果没输出，说明扩展压根没编译进 PHP 或没放在 extension_dir 目录下。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Linux（源码编译）：重装 PHP 时加
--enable-mbstring；用包管理器（如 apt/yum）安装的，通常对应包名是php-mbstring（Ubuntu/Debian）或php-mbstring（CentOS/RHEL 8+），装完会自动写好配置 - Windows：检查
php.ini中extension_dir是否指向正确的ext/目录，再确认php_mbstring.dll文件存在；去掉;extension=php_mbstring.dll前的分号即可 - 容器环境（如官方 php:alpine）：需手动
docker-php-ext-install mbstring，不能只改 ini
开了 mbstring 但 mb_strlen() 还报未定义函数
常见于 CLI 和 Web SAPI 使用不同 php.ini：php -i | grep "Loaded Configuration File" 查 CLI 加载的 ini；phpinfo() 页面查 Web 加载的 ini。两者可能完全不一致，尤其在 Nginx + PHP-FPM 场景下，FPM 自己有一套 www.conf 指定的 php_admin_value[extension]，能覆盖 php.ini。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一验证方式：在 Web 页面里执行
var_dump(function_exists('mb_strlen'));，比 CLI 测试更准 - FPM 用户重点检查
/etc/php/*/fpm/pool.d/www.conf，确认没有php_admin_value[disable_functions] = mb_strlen这类限制 - 某些共享主机禁用
mb_*系列函数，仅靠开扩展没用，得联系服务商
mb_internal_encoding() 设不设、设成啥值有影响吗
有，而且影响隐蔽。它不控制输入输出编码转换，只决定 mb_*() 函数默认使用的字符集（比如 mb_strlen($s) 默认按什么编码算长度）。不设时，PHP 7.4+ 默认为 UTF-8，但旧版本或某些 SAPI 下可能是 ISO-8859-1，导致中文字符串长度算错、截断异常。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 项目入口（如
index.php）第一行就调用mb_internal_encoding('UTF-8')，别依赖 ini 的mbstring.internal_encoding—— 它在 PHP 8.2 已被废弃 - 不要用
mb_internal_encoding()来“修复乱码”：乱码是 I/O 编码不匹配造成的，该设default_charset、HTTP header、数据库连接 charset，而不是改内部编码 - CLI 脚本务必显式设置，否则终端 locale 可能干扰结果
开启 mbstring 后性能变慢？
不会显著变慢，但有两个真实瓶颈点：一是启用 mbstring.func_overload（已从 PHP 7.2 起移除），二是大量使用 mb_regex_* 函数（PCRE 多字节正则），它们比原生 preg_* 开销大不少。普通 mb_substr()、mb_convert_encoding() 在 UTF-8 下基本无额外成本。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 绝对不要尝试用
mbstring.func_overload（老配置项）去“全局替换”字符串函数——它会让所有strlen()变成mb_strlen()，破坏兼容性且无法控制编码上下文 - 避免在循环里反复调用
mb_convert_encoding()；如需批量转码，优先用 iconv 扩展或确保源头数据编码统一 - Web 应用中，
mbstring.encoding_translation = On（自动检测 POST/GET 编码）已废弃多年，别开，它会引入不可控解析逻辑
最常被忽略的是：不同 PHP 版本对 mbstring 的默认行为差异极大，比如 PHP 7.3 之前 mb_detect_encoding() 对 UTF-8 的检测极不可靠，而 PHP 8.0+ 移除了部分过时参数。别只看有没有开启，得看具体函数在当前版本是否按你预期工作。
