已添加.po/.mo文件，如何激活WordPress.org插件的西班牙语本地化？

安全阿岳

2026-8-12

WordPress插件本地化失效排查方案

确认文本域与插件slug匹配：新版WordPress虽支持自动加载文本域，但要求文本域必须和插件slug完全一致。检查你的.po/.mo文件名是否遵循 {插件slug}-es_ES.po 和 {插件slug}-es_ES.mo 格式，比如插件slug为trelis-crypto-payments时，文件名需是trelis-crypto-payments-es_ES.po/.mo。
验证语言文件有效性：用Poedit打开.po文件，确认文件为UTF-8编码，且所有需要翻译的字符串都已正确完成翻译并编译为.mo文件，避免出现翻译条目缺失或编译错误。
明确声明文本域信息：尽管新版WP支持自动加载，但在插件主文件头部注释里明确声明文本域，能规避多数兼容性问题。示例代码如下：
```
/*
Text Domain: trelis-crypto-payments
Domain Path: /languages/
*/
```
同时确保插件内所有可翻译字符串都使用__()、_e()等函数，并传入正确的文本域参数，比如：
```
echo __( 'Pay with Crypto', 'trelis-crypto-payments' );
```
检查站点语言设置：确认WordPress后台「设置」→「常规」→「站点语言」已切换为西班牙语（es_ES），站点语言不匹配会导致本地化文件无法触发加载。
清除缓存：若站点使用缓存插件或服务器缓存，需清除所有缓存后再测试，避免旧的未翻译内容被缓存展示。