PHP无法直接编译为带完整国际化支持的Windows EXE，所谓“打包成EXE”实为将PHP解释器、脚本及浏览器内核封装；gettext需手动处理运行时locale路径且依赖扩展启用，intl在EXE中基本不可用，推荐纯PHP数组方案+手动语言选择机制。
PHP 本身不能直接编译成 Windows EXE 并自带完整国际化支持
PHP 是解释型语言，所谓“PHP 打包成 EXE”实际是用第三方工具（如 ExeOutput for PHP、WebCompiler 或 PHP Desktop）把 PHP 解释器 + 你的脚本 + 一个轻量浏览器内核打包进一个可执行文件。它不改变 PHP 的运行机制，因此 gettext、intl 扩展等国际化能力能否用，取决于打包工具是否包含对应扩展及系统级依赖（如 .mo 文件加载路径、ICU 数据库）。多数精简打包方案默认不启用 intl，gettext 也常因路径硬编码失效。
用 gettext 实现多语言需手动处理路径与环境
Windows EXE 环境下，gettext 函数（如 bindtextdomain()、textdomain()）极易因路径错误返回空字符串或触发警告。关键点不是语法写错，而是 bindtextdomain() 的第二个参数必须指向解压后实际存在的目录——这个目录在 EXE 运行时往往位于临时路径（如 C:\Users\XXX\AppData\Local\Temp\XXX\locale），而非你开发时写的 ./locale。
- 打包前把
locale/zh_CN/LC_MESSAGES/messages.mo等文件随脚本一起嵌入资源，启动时用sys_get_temp_dir()+uniqid()创建运行时 locale 目录，并用copy()提前释放 -
bindtextdomain('messages', $runtime_locale_path)中的$runtime_locale_path必须是绝对路径，且末尾不能有斜杠（gettext在 Windows 下对结尾/敏感） - 确保打包工具启用了
gettext扩展（部分工具需在配置中显式勾选，或检查生成的php.ini是否含extension=php_gettext.dll）
intl 扩展在 EXE 中基本不可靠，改用纯 PHP 的 Locale + 数组方案更稳妥
intl 依赖完整的 ICU 数据库，而绝大多数 PHP EXE 打包工具只附带最小 ICU 子集（甚至完全剔除），导致 Locale::acceptFromHttp() 返回空、NumberFormatter 构造失败、日期格式化乱码。与其调试这些，不如放弃扩展，用轻量方案：
$_LANG = [
'zh_CN' => ['hello' => '你好', 'save' => '保存'],
'en_US' => ['hello' => 'Hello', 'save' => 'Save'],
];
$lang = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? 'en_US';
$lang = substr($lang, 0, 5); // 粗略提取 zh-CN → zh_CN
$translations = $_LANG[$lang] ?? $_LANG['en_US'];
echo $translations['hello']; // 输出对应翻译
这种方案无扩展依赖、无路径问题、无编码陷阱，适合 90% 的桌面工具类 PHP EXE 场景。若需支持复数、占位符，可加一层简单模板解析，无需引入完整 symfony/translation。
立即学习“PHP免费学习笔记（深入）”；
EXE 启动时语言检测容易误判，必须提供手动切换入口
打包后的 EXE 通常以独立进程启动，$_SERVER['HTTP_ACCEPT_LANGUAGE'] 为空，getenv('LANG') 在 Windows 下也几乎无效。仅靠自动检测大概率 fallback 到英文。必须做两件事：
- 首次运行时弹出语言选择对话框（可用 PHP Desktop 的
window.showModalDialog()，或 ExeOutput 的 JS 调用PHP.ShowMessage()），将选择结果存入本地config.json或注册表 - 后续启动优先读取该持久化值，再 fallback 到系统区域设置（
GetSystemDefaultUILanguage()通过 COM 调用，但仅限 Windows，需确认打包工具支持 COM） - 界面右上角始终保留语言切换按钮，点击后实时刷新
$_SESSION['lang']并重载页面（避免整页刷新可用location.reload()+ URL 参数标记）
真正难的不是翻译本身，而是让 EXE 在离线、无 Web Server、路径不可控的环境下稳定识别并加载语言资源——每一步都要绕过打包工具的封装限制，而不是照搬 Web 开发经验。
