如何在Linux上配置pgAdmin的多语言支持

Linux上配置pgAdmin多语言支持

一 桌面版与服务器版的差异

• 桌面版（rpm/deb 包）：通过图形界面菜单设置界面语言，通常无需修改配置文件。
• 服务器模式（RPM/DEB 包）：可通过配置文件设置默认语言，并需重启服务使设置生效。
• Python 包安装（pip/pgadmin4）：同样支持图形界面设置语言；若需全局默认，可修改其配置并重启服务。

二 桌面版设置步骤

• 打开 pgAdmin 后，进入菜单：File → Preferences → Miscellaneous → User language。
• 在“User language”下拉框中选择所需语言（如：Chinese (Simplified)），保存后重启 pgAdmin即可生效。
• 菜单名称在不同版本可能略有差异，但路径均在“Preferences”中，关键词为Miscellaneous / User language。

三 服务器模式设置步骤

• 编辑 pgAdmin 配置文件（路径因发行版不同而异，常见为：/etc/pgadmin/pgadmin4.config 或 /usr/pgadmin4/venv/lib/python3.x/site-packages/pgadmin4/config_local.py）。
• 在配置文件中添加或修改默认语言项（示例）：
  • 使用键名：web_app_language = ‘zh_CN’（部分版本支持该键；若配置文件中不存在，可直接新增）。
• 保存文件并重启服务，使默认语言生效：
  • 若以系统服务运行：sudo systemctl restart pgadmin4
  • 若以 WSGI/开发服务器运行：重启对应的 gunicorn/paster 进程
• 说明：服务器模式下的“界面语言”是面向所有用户的全局默认；个人仍可在登录后通过“Preferences → Miscellaneous → User language”覆盖为自己偏好语言。

四 语言列表与生效验证

• 常用语言代码与名称示例（以 pgAdmin 内置列表为准）：
  • en：English
  • zh_Hans_CN：Chinese (Simplified)
  • zh_Hant_TW：Chinese (Traditional)
  • fr：French，de：German，ja：Japanese，ko：Korean
  • es：Spanish，ru：Russian，pt_BR：Portuguese (Brazilian)
  • it：Italian，pl：Polish，cs：Czech，id：Indonesian，sv：Swedish
• 验证要点：
  • 语言列表与可用性取决于pgAdmin 版本与安装包；若某语言未显示，先升级到较新版本再试。
  • 修改配置或翻译后，务必重启 pgAdmin 服务/进程并清理浏览器缓存后再检查效果。

五 扩展 自定义或贡献翻译

• pgAdmin 4 使用 Flask-Babel 与 GNU gettext 实现国际化：源码字符串通过 gettext/_() 标记，翻译文件位于 web/pgadmin/translations/，编译后为 .mo 文件供运行时加载。
• 若要新增语言或改进翻译，可参考官方本地化流程：提取模板（messages.pot）→ 更新/初始化语言 .po → 编译 .mo → 测试与提交贡献。