XAMPP作为常用的PHP集成开发环境，默认配置下可能没有开启mbstring扩展，这会导致程序在处理中文等多字节字符时出现乱码、字符串截取错误等问题，需要手动开启该扩展才能正常支持多字节字符处理。
什么是mbstring扩展
mbstring是PHP的一个多字节字符串处理扩展，专门用于处理中文、日文、韩文等非单字节字符集的内容。它提供了一系列函数，比如mb_strlen、mb_substr等，能够准确计算多字节字符串的长度、截取多字节字符串，避免传统字符串函数处理中文时出现半个字符的乱码问题。
Windows系统下开启mbstring扩展
Windows系统的XAMPP开启mbstring扩展的步骤如下：
- 找到XAMPP的安装目录，进入php文件夹，比如默认安装路径是
C:xamppphp - 在该目录下找到
php.ini配置文件，用记事本或其他文本编辑器打开 - 在配置文件中搜索
extension=mbstring，如果前面有分号;，把分号删掉，如果没有找到这一行，就在扩展配置区域添加extension=mbstring - 保存
php.ini文件，重启XAMPP的Apache服务，扩展就会生效
如果不确定php.ini的位置，可以创建一个PHP文件，写入以下代码查看配置路径：
<?php phpinfo(); ?>
访问这个文件，找到Loaded Configuration File项，就能看到当前生效的php.ini文件路径。
Linux系统下开启mbstring扩展
Linux系统下使用XAMPP开启mbstring扩展的步骤如下：
- 进入XAMPP的php配置目录，一般是
/opt/lampp/etc - 编辑
php.ini文件，同样搜索extension=mbstring，去掉前面的分号，或者添加该配置项 - 保存文件后，执行
/opt/lampp/lampp restartapache命令重启Apache服务
部分Linux版本的XAMPP可能需要单独安装mbstring扩展包，比如Ubuntu系统可以先执行sudo apt-get install php-mbstring，再修改php.ini配置并重启服务。
macOS系统下开启mbstring扩展
macOS的XAMPP开启步骤和Linux类似：
- 打开XAMPP安装目录下的php文件夹，路径一般是
/Applications/XAMPP/xamppfiles/etc - 修改
php.ini文件，开启mbstring扩展配置 - 通过XAMPP控制面板重启Apache服务即可
验证mbstring扩展是否生效
开启扩展后，可以通过以下代码验证是否成功开启：
<?php
// 检查mbstring扩展是否加载
if (extension_loaded('mbstring')) {
echo 'mbstring扩展已成功开启';
// 测试中文多字节字符串处理
$str = '中文测试字符串';
echo '<br>字符串长度：' . mb_strlen($str, 'utf-8');
echo '<br>截取前两个字符：' . mb_substr($str, 0, 2, 'utf-8');
} else {
echo 'mbstring扩展未开启';
}
?>
如果页面输出扩展已开启，并且能正确显示中文长度和截取结果，说明配置成功。
mbstring扩展的常见配置项
开启扩展后，还可以根据需要调整相关配置，常用的配置项有：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| mbstring.internal_encoding | 设置内部字符编码 | 无，默认使用default_charset |
| mbstring.http_output | 设置HTTP输出的字符编码 | 无 |
| mbstring.encoding_translation | 是否开启HTTP输入的编码转换 | Off |
一般处理中文时，把相关编码设置为utf-8即可满足大部分需求。
注意事项
- 修改php.ini文件前最好先备份，避免配置错误导致环境无法运行
- 修改配置后一定要重启Apache服务，否则配置不会生效
- 如果程序仍然出现中文乱码，除了开启mbstring扩展，还要检查文件本身的编码是否是utf-8，以及HTML页面是否设置了<meta charset="utf-8">编码声明
XAMPPmbstring扩展中文多字节字符PHP配置修改时间：2026-07-05 02:33:21