把PHP脚本打包成exe独立运行程序，是不少做桌面小工具开发的朋友常走的路线。但打包完成后一运行，界面上输出的中文全是问号或乱码，这种情况十有八九是默认编码没设置好。PHP在命令行或GUI环境下运行时，字符集的处理逻辑和Web环境并不一样，如果不主动指定，Windows系统会按GBK或者系统区域设置来解析字符串，乱码就出现了。本文围绕php打包exe的场景，把字符集配置的完整流程讲清楚。
一、打包前先在php.ini中设置默认编码
无论用哪种打包工具，打包进去的PHP运行环境都会读取php.ini配置文件，所以第一步就是把默认字符集参数写对。找到php.ini文件中的default_charset这一项，把它设置为UTF-8。这个参数从PHP 5.6开始默认就是UTF-8，但很多打包工具内置的PHP版本较老，默认值可能是空的，需要手动补上。
[PHP] default_charset = "UTF-8" ; 同时建议开启内部编码设置 mbstring.language = Chinese mbstring.internal_encoding = UTF-8 mbstring.http_input = UTF-8 mbstring.http_output = UTF-8 mbstring.encoding_translation = On
除了default_charset，mbstring扩展的相关配置也很关键。如果你的程序里用到了mb_substr、mb_strlen这类多字节字符串函数，mbstring.internal_encoding必须和源码文件的实际编码一致，否则切字符串时会在中文中间断开，产生半个汉字的乱码。另外iconv扩展的默认编码也可以顺手设置一下，写法是iconv.input_encoding = UTF-8和iconv.output_encoding = UTF-8。
需要提醒的是，修改php.ini之后要把文件保存为UTF-8无BOM格式。如果ini文件本身带了BOM头，PHP解析配置时可能出现奇怪的问题，这在打包后的exe里排查起来非常麻烦，因为你看不到任何报错，程序就是行为不正常。
二、ExeOutput for PHP中的字符集配置步骤
ExeOutput for PHP是目前把PHP打包成exe最常用的商业工具，它的编码配置分两个层面。第一个层面是应用设置里的人民币区域选项，打开项目后进入Application Settings，找到Localization区域，把Default language and charset设置为Chinese Simplified，对应的字符集选择gb2312或者utf-8，根据你的源码编码来定。
第二个层面是PHP配置层面。在ExeOutput左侧树形菜单中展开PHP Configuration，可以看到PHP Settings和PHP Extensions两个子项。在PHP Settings里有一个php.ini content的编辑入口，可以直接在这里追加自定义配置，把前面提到的default_charset等参数写进去，打包时会自动合并进最终的php.ini。在PHP Extensions里确认mbstring和iconv两个扩展处于勾选状态，没有这两个扩展，很多编码转换函数在exe里根本跑不起来。
还有一点容易被忽略：ExeOutput生成的exe在渲染HTML页面时用的是内置的Chromium引擎，页面里的meta声明也要写对。确保你的HTML头部包含<meta charset="UTF-8">，并且所有PHP输出的header中，如果有设置Content-Type的地方，统一带上charset=utf-8，例如header('Content-Type: text/html; charset=utf-8')。引擎渲染层和PHP输出层编码一致，显示才不会出问题。
三、PHC-Win或其他工具打包时的编码处理
PHC-Win是另一款轻量的PHP打包工具，它的工作原理是把PHP代码编译成字节码再嵌入exe。这类工具对编码的敏感度更高，因为编译阶段就会读取源文件字节。打包之前必须保证所有PHP源文件统一为UTF-8编码，如果项目里混着GBK和UTF-8的文件，编译出来的exe在不同内容处会交替出现正常和乱码，这是最典型的症状。可以用编辑器批量转换，比如在VSCode中点击右下角的编码标识，选择Reopen with Encoding确认内容，再选择Save with Encoding统一另存为UTF-8。
如果你的PHP程序要和数据库交互，连接后的字符集设置也要在代码里显式写明。以MySQL为例，不要依赖数据库服务器的默认配置，打包后的exe可能连接到任何环境，代码中主动执行编码设置才是稳妥做法。
<?php
// PDO方式连接时指定字符集
$pdo = new PDO(
'mysql:host=localhost;dbname=test;charset=utf8mb4',
'root',
'password'
);
// mysqli方式则在连接后执行
$mysqli = new mysqli('localhost', 'root', 'password', 'test');
$mysqli->set_charset('utf8mb4');
// 输出内容前统一设置编码
mb_internal_encoding('UTF-8');
echo mb_substr('中文字符串截取测试', 0, 4);
对于把PHP脚本封装成控制台程序的场景，Windows的cmd默认代码页是936也就是GBK，即使你的PHP输出是UTF-8，在cmd窗口里照样乱码。解决办法要么在输出的开头执行system('chcp 65001')把代码页切到UTF-8，要么干脆把输出内容用mb_convert_encoding($str, 'GBK', 'UTF-8')转成GBK再输出。前者通用性更好，后者适合不能改动控制台属性的场景。
四、打包后乱码问题的排查思路
如果按照上面的步骤配置完，exe运行还是有乱码，可以按顺序排查。第一步确认乱码出现的环节：是PHP处理数据时乱，还是显示到界面上才乱。可以在exe里临时加一段代码，把字符串的每个字节写进日志文件，用十六进制查看工具确认原始字节是UTF-8还是GBK，这样能快速定位是数据层的问题还是显示层的问题。
第二步检查打包工具是否覆盖了你的php.ini。有些工具在打包时会用自己的默认配置文件，你在项目里改的php.ini并没有生效。验证方法很简单，在exe里执行echo ini_get('default_charset')，看输出值是不是UTF-8，如果不是说明配置没被读取，需要通过工具提供的自定义配置入口重新写入。
第三步考虑系统区域因素。目标机器如果开启了Windows的Beta版UTF-8全局支持选项，或者系统区域设置成非中文环境，字符集的默认行为会跟着变。为了让exe在任何机器上表现一致，最保险的做法是在程序入口处主动声明所有编码，不依赖任何系统默认值：入口文件里调用mb_internal_encoding('UTF-8')，文件读写操作统一给file_get_contents、fopen等函数明确指定编码上下文，数据库连接指定charset，HTML输出声明charset。四个环节全部锁定UTF-8之后，乱码基本就没有生存空间了。
总体来说，php打包exe的编码问题核心就一句话：从源码文件到PHP运行时，再到输出显示，每一层的字符集都要显式指定且保持一致。把配置工作做在打包之前，远比打包完再反复返工省事得多。